Skip to content
CAPA CAPA CAPA Docs

Quick Start (managed)

Get a managed capa project running in a few minutes: one capabilities file, an install that fans out to your providers, and a local server you can check with capa status.

  1. Initialize the project

    From your project root:

    Terminal window
    capa init

    This creates capabilities.yaml (or .json if you choose JSON) and registers the project with the local capa server/database.

  2. Add a skill

    Point at a skill from GitHub (or another supported source):

    Terminal window
    capa add owner/repo@skill-name

    Or edit capabilities.yaml by hand, then continue. Secrets belong in ${VarName} placeholders — never paste API keys into the file.

  3. Install

    Terminal window
    capa install

    capa fans out skills, MCP config, rules, hooks, and agents to your configured providers, then starts the capa server (around localhost:5912). If credentials are needed, the web UI opens so you can fill them in.

  4. Verify

    Check that the server is up:

    Terminal window
    capa status

    Exercise a tool from the CLI when you have one registered:

    Terminal window
    capa sh <group> <tool> --help

What’s next

Section titled “What’s next”