capa clean

Remove all CAPA-managed skills and configurations from MCP clients.

Usage

capa clean

Description

Removes all files and configurations that were installed by CAPA, including:

  • Skill directories in MCP clients (e.g., .cursor/skills/, ~/Library/Application Support/Claude/skills/)
  • CAPA-managed snippets from AGENTS.md and CLAUDE.md (when the agents section is configured)
  • MCP client configuration entries for CAPA
  • Registered project endpoints

What Gets Cleaned

Skill Directories

  • .cursor/skills/ (Cursor)
  • ~/Library/Application Support/Claude/skills/ (Claude Desktop - macOS)
  • %APPDATA%\Claude\skills\ (Claude Desktop - Windows)

Agent Instructions Files

When the capabilities file has an agents section, CAPA removes all capa-owned blocks (wrapped in <!-- capa:start:id --> markers) from AGENTS.md and CLAUDE.md. If a file is entirely empty after removing capa blocks, it is deleted. Content you wrote outside the markers is preserved.

MCP Configuration

  • CAPA server entries in .cursor/mcp.json
  • CAPA server entries in Claude Desktop config files

What Does NOT Get Cleaned

  • The capabilities.yaml or capabilities.json file in your project
  • Content in AGENTS.md / CLAUDE.md written outside capa markers
  • The CAPA server (it will keep running)
  • Credentials stored in ~/.capa/capa.db
  • Server logs in ~/.capa/logs/

When to Use

  • Before reinstalling with capa install to start fresh
  • When removing CAPA from a project
  • To resolve issues with stale skill installations
  • When changing MCP client providers

Typical Workflow

Clean and reinstall:

capa clean
capa install

Notes

  • This command is safe to run and won't delete your project files
  • You'll need to run capa install again to restore functionality
  • Your MCP client may need to be restarted after cleaning

Related Commands