capa registry

Inspect the third-party skill and plugin registries that CAPA has loaded.

Usage

capa registry              # alias for "capa registry list"
capa registry list         # list all configured registries
capa registry path         # print the registries directory path

Description

Registries are discovered automatically from ~/.capa/registries/ when the CAPA server starts. The capa registry command lets you see which adapters are loaded, what they expose, and where to drop new adapter files.

See the Registries documentation for the full adapter API and example adapters (skills.sh, Cursor Marketplace).

Subcommands

capa registry list

Lists every adapter CAPA has loaded, along with its display name, ID, description, homepage, and the capabilities (skills or plugins) it provides.

Found 2 registry(ies):

  Skills.sh (skills-sh)
    Curated, community-maintained agent skills
    Homepage: https://skills.sh
    Capabilities: skills

  Cursor Marketplace (cursor-marketplace)
    Official Cursor plugin marketplace
    Homepage: https://cursor.com/marketplace
    Capabilities: plugins

Note: Registry adapters are executable TypeScript. Only use files from sources you trust.

If no adapters are present, CAPA prints the registries directory path and a pointer to the docs:

No registries configured.

Place .ts adapter files in: /Users/you/.capa/registries
See https://capa.infragate.ai for examples.

capa registry path

Prints the absolute path of the registries directory. Handy for scripts and one-liners:

# Open the registries folder in your file manager
open "$(capa registry path)"

# Drop a new adapter into the directory
cp my-registry.ts "$(capa registry path)/"

Examples

Add and Verify a Registry

# 1. Copy an example adapter into the registries directory
cp registries/skills-sh.ts ~/.capa/registries/

# 2. Restart the server so the adapter is picked up
capa restart

# 3. Confirm it's loaded
capa registry list

# 4. Install an item from it
capa add skills-sh:web-researcher

Security Note

Adapter files are TypeScript modules executed inside the CAPA server. They have full access to the network and filesystem. Only install adapter files from sources you trust. CAPA prints this reminder at the end of every capa registry list output.

Related Commands

  • Registries: adapter API and how registries work.
  • capa add: install items via capa add <registryId>:<itemId>.
  • capa restart: required after adding or modifying an adapter.