{
  "name": "ClaimFS",
  "description": "Instant cloud filesystems for AI agents.",
  "baseUrl": "https://claimfs.com",
  "llms": "https://claimfs.com/llms.txt",
  "agentGuide": "https://claimfs.com/agent.md",
  "install": "curl -fsSL https://claimfs.com/install.sh | bash",
  "openapi": "https://claimfs.com/openapi.json",
  "commands": "https://claimfs.com/api/commands",
  "quickstart": [
    "claimfs create \"Agent workspace\"",
    "save the one-time accessToken and claimToken from create output",
    "use accessToken with CLI --grant or HTTP X-ClaimFS-Grant, not Authorization Bearer",
    "claimfs mount <slug> ./workspace --grant <accessToken>",
    "claimfs exec <slug> --grant <accessToken> \"pwd && ls -la\"",
    "claimfs agent join <slug> claude --agent-id claude --grant <accessToken>",
    "claimfs exec <slug> --grant <workspaceToken> --workspace /agents/<agent-id> -- \"echo hi > hello.txt && rm hello.txt\"",
    "claimfs unmount ./workspace"
  ],
  "tokenRules": {
    "accessToken": "filesystem grant token; use CLI --grant or HTTP X-ClaimFS-Grant",
    "grantToken": "filesystem grant token; use CLI --grant or HTTP X-ClaimFS-Grant",
    "apiKey": "account API key from claimfs login; use Authorization: Bearer <CLAIMFS_API_KEY>"
  },
  "httpHelloWorld": [
    "POST /api/v1/filesystems with {\"name\":\"hello world\",\"ttlHours\":1}",
    "save filesystem.slug and accessToken",
    "PUT /api/v1/filesystems/{slug}/files with X-ClaimFS-Grant: <accessToken> and {\"path\":\"/hello.txt\",\"content\":\"hello world\\n\",\"encoding\":\"text\"}",
    "GET /api/v1/filesystems/{slug}/files?op=read&encoding=text&path=/hello.txt with X-ClaimFS-Grant: <accessToken>"
  ],
  "accountQuickstart": [
    "claimfs login user@example.com",
    "claimfs create \"Agent workspace\"",
    "claimfs mount <slug> ./workspace"
  ],
  "agentWorkspace": [
    "POST /api/v1/filesystems/{slug}/agents creates a normal directory such as /agents/claude-abc12 and returns a scoped grant token",
    "Use claimfs agent join <slug> <label> --grant <token> for the CLI happy path",
    "Use /agents/<id> for each active agent and /shared/<topic> for intentional collaboration",
    "Exec checks out cwd by default so file edits, moves, and deletes persist cleanly in shared mode",
    "Use relative paths inside exec commands; absolute shell paths refer to the sandbox host unless using /mnt/archil",
    "Exec sets CLAIMFS_ROOT=/mnt/archil and WORKSPACE=/mnt/archil for scripts that need absolute filesystem paths",
    "Use GET /files?recursive=true for tree listing and GET /files?op=stat for cheap existence checks",
    "System paths are hidden by default; use includeHidden=true or --include-hidden to inspect them"
  ]
}