Skip to content

SKILL.md

Latest commit

 

History

History
58 lines (47 loc) · 1.78 KB

SKILL.md

File metadata and controls

58 lines (47 loc) · 1.78 KB

Agent Filesystem

Agent Filesystem is now a workspace-first system for agents. Redis is still the canonical store, but the active user surfaces are:

  • afs mcp for agent clients
  • afs ws mount <workspace> <directory> for a normal local working directory
  • afs config set --mode mount before mount for a live Redis-backed mount
  • explicit checkpoints via afs cp ...

The old direct-command storage surface is retired and should not be used as the mental model for this repo.

Fast Start

make commands
./afs auth login
./afs ws create demo
./afs ws mount demo ~/demo
cd ~/demo

Most Useful Commands

./afs ws create <workspace>
./afs ws import <workspace> <directory>
./afs ws mount <workspace> <directory>
./afs ws unmount <workspace-or-directory>
./afs ws list
./afs ws fork <workspace> <new-workspace>
./afs cp create <workspace> <name>
./afs cp list <workspace>
./afs cp restore <workspace> <name>
./afs fs grep --workspace <workspace> "pattern"
./afs config set --mode sync
./afs config set --mode mount
./afs status
./afs mcp

Working Model

  • Redis stores the live workspace state plus checkpoint history.
  • Sync mode gives you a real local directory that is reconciled with Redis.
  • Mount mode exposes the live workspace directly through NFS/FUSE.
  • MCP talks to the same workspace model without requiring a local directory.
  • File edits update the live workspace immediately; create checkpoints explicitly when you want a durable restore point.

Read Next

  • README.md for the current product story and setup flow
  • docs/README.md for the current documentation index
  • plans/README.md for active and archived planning artifacts
  • docs/internals/repo-walkthrough.md for the current tree layout
  • skills/agent-filesystem/SKILL.md for the installable agent skill