filcopilot

fil-copilot is a Filecoin-focused agent that helps Storage Providers (SPs) and developers work with the Filecoin network using structured tools and real on-chain data.

The project aims to reduce the operational and learning overhead of Filecoin by turning common but complex workflows into repeatable, verifiable tasks. It does not replace existing Filecoin tooling, but coordinates them through a single, task-oriented interface.

Motivation

Filecoin has a mature but complex protocol and operational stack. Many tasks require deep ecosystem knowledge, multiple tools, and careful configuration.

General-purpose language models are not sufficient for this:

• they do not have access to accurate, up-to-date chain state
• they cannot safely perform or assist with on-chain operations
• they provide commands without understanding real execution context

fil-copilot addresses this by combining:

• read-only access to live Filecoin chain data
• explicit, permissioned execution workflows
• task-level abstractions built on top of existing Filecoin tools

Scope

fil-copilot is designed as a general Filecoin agent, with current development focused on reducing the barrier for Storage Providers to participate in Filecoin Warm Storage Service (FWSS).

This includes:

• understanding FWSS-related on-chain state and requirements
• guiding and validating multi-component deployments
• structuring FWSS operations into repeatable tasks

The same model is intended to be reusable for other Filecoin workflows.

Safety Model

fil-copilot does not hold private keys and is not a trusted execution authority.

• The agent produces structured action plans
• All signing and execution happen in user-controlled environments
• On-chain write operations require explicit user approval
• Read-only operations are enabled by default

This design avoids introducing new trust assumptions while still improving usability.

Project Status

This project is under active development.

Initial milestones focus on:

• read-only chain analysis and query tools
• FWSS-oriented deployment and operational workflows
• documentation and reproducible examples

Non-goals

• This project is not a replacement for Lotus or Curio
• This project does not manage funds or custody keys