Agentfs Claude

Coding Agent + AgentFS + LlamaIndex Workflows

A demo where we run Claude Code or Codex within a fully-virtualized file system (AgentFS), orchestrating it with LlamaIndex Workflows and adding the possibility of reading unstructured files (e.g. PDFs or Word/Google docs) with LlamaCloud.

Set Up and Run

Clone this repository:

Install all necessary dependencies:

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):

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):

The MCP will be live on http://localhost:3000/mcp, and you will need to add the MCP configuration in 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 file, containing the instructions on how to use the server.

Now run the demo with:

And follow the prompts in the terminal

How it works

All the filesystem-bound operations are performed on the AgentFS (and not on the real files), thanks to the filesystem MCP 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 and the new string to replace the old one with
- list_files: list all the available files
- file_exists: check whether or not a file exists, providing its path

What happens under the hood when the agent is running:

- All text-based files in the current directory are uploaded to a LibSQL database and indexed
- Non text-based files (namely in PDF/DOCX/DOC/PPTX/XLSX format) are parsed…