Agentfs Claude

Coding Agent + AgentFS + LlamaIndex Workflows

A demo where we run Claude Code or Codex within a fully-virtualized file system ([AgentFS](https://github.com/tursodatabase/agentfs)), orchestrating it with [LlamaIndex Workflows](https://github.com/run-llama/workflows-ts) and adding the possibility of reading unstructured files (e.g. PDFs or Word/Google docs) with [LlamaCloud](https://cloud.llamaindex.ai).

Set Up and Run

Clone this repository:

git clone https://github.com/run-llama/agentfs-claude
cd agentfs-claude

Install all necessary dependencies:

pnpm install 
# you can use other package managers, but pnpm is preferred

If you wish to use the demo with Codex, you need to install the Codex SDK separately (given the size of the library - 140+ MB - its download it disabled by default):

pnpm add @openai/codex-sdk

Moreover, if you wish to run the demo with Codex, you also need to start the MCP server (from a different terminal window, but within the same directory):

pnpm run mcp-start

The MCP will be live on `http://localhost:3000/mcp`, and you will need to add the MCP configuration in [config.toml](./codex/config.toml) to the global Codex configuration in `$HOME/.codex/config.toml`. If you want Codex to use the filesystem MCP by default, you will also need to copy the [AGENTS.md](./codex/AGENTS.md) file, containing the instructions on how to use the server.

Now run the demo with:

# for the first time
pnpm run start

# If you want to add more files to the database
pnpm run clean-start

And follow the prompts in the terminal

How it works

All the [filesystem-bound operations](./src/filesystem.ts) are performed on the AgentFS (and not on the real files), thanks to the [`filesystem` MCP](./src/mcp.ts) that exposes the following tools:

• read_file: read a file, providing its path
• write_file: write a file, providing its path and content
• edit_file: edit a file, providing the old string a