{
  "name": "capabilities.sh documentation",
  "site": "https://capabilities.sh",
  "asOf": "2026-11-06",
  "status": {
    "stage": "in development",
    "milestone": "M1",
    "milestoneState": "in progress",
    "units": {
      "merged": 11,
      "inReview": 1,
      "notStarted": 8,
      "total": 20
    },
    "page": "https://capabilities.sh/status"
  },
  "llms": "https://capabilities.sh/llms.txt",
  "llmsFull": "https://capabilities.sh/llms-full.txt",
  "pages": [
    {
      "title": "Overview",
      "description": "What the capability hub is, how one MCP endpoint gives every agent your tools, and what exists today.",
      "section": "Start",
      "url": "https://capabilities.sh/docs",
      "markdown": "https://capabilities.sh/docs.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Why one endpoint",
          "anchor": "why-one-endpoint",
          "url": "https://capabilities.sh/docs#why-one-endpoint"
        },
        {
          "depth": 2,
          "text": "How a request flows",
          "anchor": "how-a-request-flows",
          "url": "https://capabilities.sh/docs#how-a-request-flows"
        },
        {
          "depth": 2,
          "text": "Local first, hosted later",
          "anchor": "local-first-hosted-later",
          "url": "https://capabilities.sh/docs#local-first-hosted-later"
        },
        {
          "depth": 2,
          "text": "What exists today",
          "anchor": "what-exists-today",
          "url": "https://capabilities.sh/docs#what-exists-today"
        },
        {
          "depth": 2,
          "text": "Read next",
          "anchor": "read-next",
          "url": "https://capabilities.sh/docs#read-next"
        }
      ]
    },
    {
      "title": "Quickstart",
      "description": "The first local run, step by step. Build the CLI from a checkout, import what your agents already have, connect them, and approve a write. The hub steps are planned for M1.",
      "section": "Start",
      "url": "https://capabilities.sh/docs/quickstart",
      "markdown": "https://capabilities.sh/docs/quickstart.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Before you start",
          "anchor": "before-you-start",
          "url": "https://capabilities.sh/docs/quickstart#before-you-start"
        },
        {
          "depth": 2,
          "text": "1. Build the CLI",
          "anchor": "build",
          "url": "https://capabilities.sh/docs/quickstart#build"
        },
        {
          "depth": 2,
          "text": "2. Create the hub and import",
          "anchor": "import",
          "url": "https://capabilities.sh/docs/quickstart#import"
        },
        {
          "depth": 2,
          "text": "3. Review what the hub may do",
          "anchor": "review",
          "url": "https://capabilities.sh/docs/quickstart#review"
        },
        {
          "depth": 2,
          "text": "4. Connect your agents",
          "anchor": "connect",
          "url": "https://capabilities.sh/docs/quickstart#connect"
        },
        {
          "depth": 2,
          "text": "5. Ask for something that writes",
          "anchor": "first-run",
          "url": "https://capabilities.sh/docs/quickstart#first-run"
        },
        {
          "depth": 2,
          "text": "6. Check health",
          "anchor": "doctor",
          "url": "https://capabilities.sh/docs/quickstart#doctor"
        },
        {
          "depth": 2,
          "text": "Add a source by hand",
          "anchor": "add",
          "url": "https://capabilities.sh/docs/quickstart#add"
        },
        {
          "depth": 2,
          "text": "What's next",
          "anchor": "whats-next",
          "url": "https://capabilities.sh/docs/quickstart#whats-next"
        }
      ]
    },
    {
      "title": "Concepts",
      "description": "The hub's vocabulary, from source and namespace to run, journal and decision. Generated from the project glossary so it always matches the code.",
      "section": "Start",
      "url": "https://capabilities.sh/docs/concepts",
      "markdown": "https://capabilities.sh/docs/concepts.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "The hub",
          "anchor": "the-hub",
          "url": "https://capabilities.sh/docs/concepts#the-hub"
        },
        {
          "depth": 3,
          "text": "Hub",
          "anchor": "hub",
          "url": "https://capabilities.sh/docs/concepts#hub"
        },
        {
          "depth": 3,
          "text": "Source",
          "anchor": "source",
          "url": "https://capabilities.sh/docs/concepts#source"
        },
        {
          "depth": 3,
          "text": "Namespace",
          "anchor": "namespace",
          "url": "https://capabilities.sh/docs/concepts#namespace"
        },
        {
          "depth": 3,
          "text": "Tool address",
          "anchor": "tool-address",
          "url": "https://capabilities.sh/docs/concepts#tool-address"
        },
        {
          "depth": 3,
          "text": "Connection",
          "anchor": "connection",
          "url": "https://capabilities.sh/docs/concepts#connection"
        },
        {
          "depth": 3,
          "text": "Policy",
          "anchor": "policy",
          "url": "https://capabilities.sh/docs/concepts#policy"
        },
        {
          "depth": 3,
          "text": "Tool contract",
          "anchor": "tool-contract",
          "url": "https://capabilities.sh/docs/concepts#tool-contract"
        },
        {
          "depth": 3,
          "text": "Index",
          "anchor": "index",
          "url": "https://capabilities.sh/docs/concepts#index"
        },
        {
          "depth": 3,
          "text": "Run",
          "anchor": "run",
          "url": "https://capabilities.sh/docs/concepts#run"
        },
        {
          "depth": 3,
          "text": "Journal",
          "anchor": "journal",
          "url": "https://capabilities.sh/docs/concepts#journal"
        },
        {
          "depth": 3,
          "text": "Profile",
          "anchor": "profile",
          "url": "https://capabilities.sh/docs/concepts#profile"
        },
        {
          "depth": 3,
          "text": "Sandbox",
          "anchor": "sandbox",
          "url": "https://capabilities.sh/docs/concepts#sandbox"
        },
        {
          "depth": 3,
          "text": "Decision",
          "anchor": "decision",
          "url": "https://capabilities.sh/docs/concepts#decision"
        },
        {
          "depth": 2,
          "text": "Also used",
          "anchor": "also-used",
          "url": "https://capabilities.sh/docs/concepts#also-used"
        },
        {
          "depth": 3,
          "text": "Capability",
          "anchor": "capability",
          "url": "https://capabilities.sh/docs/concepts#capability"
        },
        {
          "depth": 3,
          "text": "Client",
          "anchor": "client",
          "url": "https://capabilities.sh/docs/concepts#client"
        },
        {
          "depth": 3,
          "text": "Secret store",
          "anchor": "secret-store",
          "url": "https://capabilities.sh/docs/concepts#secret-store"
        }
      ]
    },
    {
      "title": "The CLI",
      "description": "Every capabilities hub command and the milestone that brings it, plus the census and stack commands that exist in the repository today.",
      "section": "Reference",
      "url": "https://capabilities.sh/docs/cli",
      "markdown": "https://capabilities.sh/docs/cli.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "capabilities hub",
          "anchor": "hub",
          "url": "https://capabilities.sh/docs/cli#hub"
        },
        {
          "depth": 3,
          "text": "Setup",
          "anchor": "setup",
          "url": "https://capabilities.sh/docs/cli#setup"
        },
        {
          "depth": 3,
          "text": "Credentials and access",
          "anchor": "credentials",
          "url": "https://capabilities.sh/docs/cli#credentials"
        },
        {
          "depth": 3,
          "text": "Serving and running",
          "anchor": "serving",
          "url": "https://capabilities.sh/docs/cli#serving"
        },
        {
          "depth": 3,
          "text": "Hosted",
          "anchor": "hosted",
          "url": "https://capabilities.sh/docs/cli#hosted"
        },
        {
          "depth": 2,
          "text": "Where the hub keeps its files",
          "anchor": "files",
          "url": "https://capabilities.sh/docs/cli#files"
        },
        {
          "depth": 2,
          "text": "The CLI today",
          "anchor": "today",
          "url": "https://capabilities.sh/docs/cli#today"
        }
      ]
    },
    {
      "title": "The MCP surface",
      "description": "The three tools a code-mode profile exposes, what the model's code can and cannot do inside the sandbox, how approvals travel over MCP, and the default limits.",
      "section": "Reference",
      "url": "https://capabilities.sh/docs/mcp",
      "markdown": "https://capabilities.sh/docs/mcp.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "search",
          "anchor": "search",
          "url": "https://capabilities.sh/docs/mcp#search"
        },
        {
          "depth": 2,
          "text": "describe",
          "anchor": "describe",
          "url": "https://capabilities.sh/docs/mcp#describe"
        },
        {
          "depth": 2,
          "text": "execute",
          "anchor": "execute",
          "url": "https://capabilities.sh/docs/mcp#execute"
        },
        {
          "depth": 2,
          "text": "Inside the sandbox",
          "anchor": "sandbox",
          "url": "https://capabilities.sh/docs/mcp#sandbox"
        },
        {
          "depth": 2,
          "text": "Approvals over MCP",
          "anchor": "approvals",
          "url": "https://capabilities.sh/docs/mcp#approvals"
        },
        {
          "depth": 2,
          "text": "Default limits",
          "anchor": "limits",
          "url": "https://capabilities.sh/docs/mcp#limits"
        },
        {
          "depth": 2,
          "text": "Arriving in M2",
          "anchor": "m2",
          "url": "https://capabilities.sh/docs/mcp#m2"
        }
      ]
    },
    {
      "title": "Security and approvals",
      "description": "The four control promises in detail. Policy decides every call, only a person records a decision, contracts pin what you approved, secrets stay in your keychain, and code runs with no network.",
      "section": "Reference",
      "url": "https://capabilities.sh/docs/security",
      "markdown": "https://capabilities.sh/docs/security.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Policy decides every call",
          "anchor": "policy",
          "url": "https://capabilities.sh/docs/security#policy"
        },
        {
          "depth": 2,
          "text": "Only a person approves",
          "anchor": "approvals",
          "url": "https://capabilities.sh/docs/security#approvals"
        },
        {
          "depth": 2,
          "text": "Contracts pin what you approved",
          "anchor": "contracts",
          "url": "https://capabilities.sh/docs/security#contracts"
        },
        {
          "depth": 2,
          "text": "Secrets stay out of reach",
          "anchor": "secrets",
          "url": "https://capabilities.sh/docs/security#secrets"
        },
        {
          "depth": 2,
          "text": "Code runs with no way out",
          "anchor": "sandbox",
          "url": "https://capabilities.sh/docs/security#sandbox"
        },
        {
          "depth": 2,
          "text": "Resume never repeats a call",
          "anchor": "resume",
          "url": "https://capabilities.sh/docs/security#resume"
        },
        {
          "depth": 2,
          "text": "The invariants",
          "anchor": "invariants",
          "url": "https://capabilities.sh/docs/security#invariants"
        },
        {
          "depth": 2,
          "text": "What the hub cannot protect against",
          "anchor": "limits",
          "url": "https://capabilities.sh/docs/security#limits"
        },
        {
          "depth": 2,
          "text": "Telemetry",
          "anchor": "telemetry",
          "url": "https://capabilities.sh/docs/security#telemetry"
        }
      ]
    },
    {
      "title": "FAQ",
      "description": "Short answers about release status, code mode, approvals, secrets, supported agents, open source and pricing.",
      "section": "Reference",
      "url": "https://capabilities.sh/docs/faq",
      "markdown": "https://capabilities.sh/docs/faq.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Can I install it today?",
          "anchor": "install",
          "url": "https://capabilities.sh/docs/faq#install"
        },
        {
          "depth": 2,
          "text": "How is this different from adding MCP servers to each agent?",
          "anchor": "why-a-hub",
          "url": "https://capabilities.sh/docs/faq#why-a-hub"
        },
        {
          "depth": 2,
          "text": "Why code instead of tool calls?",
          "anchor": "why-code",
          "url": "https://capabilities.sh/docs/faq#why-code"
        },
        {
          "depth": 2,
          "text": "Can the model approve its own write?",
          "anchor": "self-approval",
          "url": "https://capabilities.sh/docs/faq#self-approval"
        },
        {
          "depth": 2,
          "text": "Does the model ever see my API keys?",
          "anchor": "secrets",
          "url": "https://capabilities.sh/docs/faq#secrets"
        },
        {
          "depth": 2,
          "text": "What happens when a tool changes upstream?",
          "anchor": "drift",
          "url": "https://capabilities.sh/docs/faq#drift"
        },
        {
          "depth": 2,
          "text": "Which agents work with it?",
          "anchor": "agents",
          "url": "https://capabilities.sh/docs/faq#agents"
        },
        {
          "depth": 2,
          "text": "Does it run skills?",
          "anchor": "skills",
          "url": "https://capabilities.sh/docs/faq#skills"
        },
        {
          "depth": 2,
          "text": "Is it open source?",
          "anchor": "open-source",
          "url": "https://capabilities.sh/docs/faq#open-source"
        },
        {
          "depth": 2,
          "text": "What will it cost?",
          "anchor": "pricing",
          "url": "https://capabilities.sh/docs/faq#pricing"
        },
        {
          "depth": 2,
          "text": "Which operating systems?",
          "anchor": "os",
          "url": "https://capabilities.sh/docs/faq#os"
        },
        {
          "depth": 2,
          "text": "Where does my data live?",
          "anchor": "data",
          "url": "https://capabilities.sh/docs/faq#data"
        },
        {
          "depth": 2,
          "text": "Who makes it?",
          "anchor": "who",
          "url": "https://capabilities.sh/docs/faq#who"
        }
      ]
    },
    {
      "title": "For agents",
      "description": "How this site serves agents (llms.txt, Markdown twins of every page, a JSON docs index, stable anchors, structured data) and the setup snippets that point Claude Code, Codex and Cursor at the hub.",
      "section": "Project",
      "url": "https://capabilities.sh/agents",
      "markdown": "https://capabilities.sh/agents.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Entry points",
          "anchor": "entry-points",
          "url": "https://capabilities.sh/agents#entry-points"
        },
        {
          "depth": 2,
          "text": "Conventions on every page",
          "anchor": "conventions",
          "url": "https://capabilities.sh/agents#conventions"
        },
        {
          "depth": 2,
          "text": "Crawling",
          "anchor": "crawling",
          "url": "https://capabilities.sh/agents#crawling"
        },
        {
          "depth": 2,
          "text": "Connect an agent to the hub",
          "anchor": "connect-an-agent",
          "url": "https://capabilities.sh/agents#connect-an-agent"
        },
        {
          "depth": 2,
          "text": "The hosted endpoint",
          "anchor": "hosted",
          "url": "https://capabilities.sh/agents#hosted"
        },
        {
          "depth": 2,
          "text": "If you are an agent reading this",
          "anchor": "notes-for-agents",
          "url": "https://capabilities.sh/agents#notes-for-agents"
        }
      ]
    },
    {
      "title": "Status and roadmap",
      "description": "Where the hub stands. Milestone M1, the local hub, is in progress and nothing is released. The unit list is generated from the plan of record and the repository's history.",
      "section": "Project",
      "url": "https://capabilities.sh/status",
      "markdown": "https://capabilities.sh/status.md",
      "updated": "2026-11-06",
      "headings": [
        {
          "depth": 2,
          "text": "Milestones",
          "anchor": "milestones",
          "url": "https://capabilities.sh/status#milestones"
        },
        {
          "depth": 2,
          "text": "M1, unit by unit",
          "anchor": "m1-units",
          "url": "https://capabilities.sh/status#m1-units"
        },
        {
          "depth": 2,
          "text": "Journeys",
          "anchor": "journeys",
          "url": "https://capabilities.sh/status#journeys"
        },
        {
          "depth": 2,
          "text": "How this page is made",
          "anchor": "source",
          "url": "https://capabilities.sh/status#source"
        }
      ]
    }
  ]
}