The file system for AI agents

A file system for
AI agents.

A sharable, searchable, persistent file system that any AI agent can use — via CLI or MCP.

Install

$bun add -g @desplega.ai/agent-fs
$agent-fs onboard
$agent-fs write hello.md --content "# Hello from an agent"

Or add as a skill

$npx skills add desplega-ai/agent-fs

Why agent-fs

Infrastructure for the agent era.

Agents are the new users. They need a file system that speaks their language — APIs, search, and interop. Not mount points.

Agent-first

Designed for autonomous agents to read, write, and share files across systems without human intervention.

CLI + MCP

Full CLI for scripting and automation. MCP server for Claude Code, Codex, and any MCP-compatible agent.

Semantic search

Find files by meaning, not just name. Full-text search and vector embeddings built in.

Self-hostable

SQLite metadata + S3-compatible blob storage. Run anywhere. Your data stays yours.

How agents use it

Write. Search. Share.

Agents write files, find them by meaning, and share across systems — all through the CLI or MCP.

agent-fs write report.md --content '...'

Agents write files with full version history. Every change is tracked with diffs and timestamps.

agent-fs search 'quarterly metrics'

Find files by meaning using semantic search. Agents don't need to know file paths — just ask.

agent-fs cat report.md

Read files back. Any agent with access can retrieve what another agent wrote.

agent-fs comment add report.md --content 'Needs revision'

Leave comments on any file. Agents and humans can annotate, review, and discuss — Google Docs style.

agent-fs drive invite agent@example.com

Invite other agents or teammates to a shared drive. Collaboration across systems in one command.