Commands

The kapacitor CLI command surface, grouped by what you’d reach for. For every command, kapacitor <command> --help gives the full flag list. This page is a navigable summary.

Setup and auth

kapacitor setup                                   # interactive wizard
kapacitor setup --server-url <url> --no-prompt    # scripted / CI
kapacitor login                                   # OAuth in browser
kapacitor login --device                          # device flow (SSH / headless)
kapacitor logout                                  # delete stored tokens
kapacitor whoami                                  # show authenticated user
kapacitor status                                  # server health check

Tokens are stored at ~/.config/kapacitor/tokens.json. Auth0 tokens auto-refresh; direct GitHub tokens expire after 24 hours and the next CLI call will reprompt.

See Install the CLI for the wizard walkthrough.

Session lookup

kapacitor recap <sessionId>                    # AI-generated summary
kapacitor recap --full <sessionId>             # complete transcript
kapacitor recap --chain <sessionId>            # across the continuation chain
kapacitor recap --chain --full <sessionId>

kapacitor errors <sessionId>                   # extract tool-call errors
kapacitor errors --chain <sessionId>

kapacitor validate-plan <sessionId>            # verify all plan items completed

The identifier can be a session GUID or a meta-session slug. Inside Claude or Codex with the plugin installed, the session ID is resolved from the environment automatically.

More: Session recap, Errors & plan validation.

Recording control

kapacitor hide                  # mark current session owner-only
kapacitor hide <sessionId>      # specific session

kapacitor disable               # stop recording + delete server data (irreversible)
kapacitor disable <sessionId>

kapacitor ignore .              # ignore current directory (no capture for sessions under it)
kapacitor ignore ~/code/x
kapacitor ignore --list
kapacitor ignore --remove ~/code/x

More: Visibility & sharing.

Evaluations and review

kapacitor eval <sessionId>                       # LLM-as-judge, 13 questions
kapacitor eval --model opus <sessionId>
kapacitor eval --chain <sessionId>
kapacitor eval --questions safety <sessionId>
kapacitor eval --skip efficiency <sessionId>
kapacitor eval --threshold 5000 <sessionId>
kapacitor eval --list-questions

kapacitor review <pr-url>                        # Claude with MCP context tools

More: Evaluations, PR review.

MCP servers (for agents)

kapacitor mcp sessions                           # stdio MCP server: search past sessions

The Kapacitor plugin (installed by kapacitor setup) auto-registers this server for both Claude Code and Codex CLI, so it’s available out of the box on either harness.

The server is repo-aware — cd into a project before launching the agent and search_sessions defaults to that repo. Three tools: search_sessions, get_session_summary, get_session_transcript. See Session recall.

Importing past sessions

kapacitor import --all                         # every discovered session (Claude)
kapacitor import --org
kapacitor import --repo owner/repo
kapacitor import --repo .
kapacitor import --codex --org                 # Codex rollouts
kapacitor import --org --private
kapacitor import --org --since 2026-01-01
kapacitor import --org --cwd /path
kapacitor import --org --session abc123

kapacitor cursor import                          # current Cursor workspace
kapacitor cursor import --workspace /path
kapacitor cursor import --all

More: Import your history.

Hooks and plugin

kapacitor plugin install                         # Claude hooks, user scope
kapacitor plugin install --codex                 # Codex hooks + agent skills, user scope
kapacitor plugin install --skills                # Agent skills only (~/.agents/skills/), no Codex hooks
kapacitor plugin install --project               # Claude hooks, current repo
kapacitor plugin install --codex --project       # Codex hooks in <repo>/.codex/hooks.json, skills user-wide
kapacitor plugin remove --codex                  # Remove Codex hooks + agent skills
kapacitor plugin remove --skills                 # Remove agent skills

--skills installs the five kapacitor skills (kapacitor-recap, kapacitor-errors, kapacitor-hide, kapacitor-disable, kapacitor-validate-plan) to ~/.agents/skills/. Codex, Cursor, and any agent that honours the .agents/skills/ convention picks them up automatically. Use --codex instead to also install Codex hooks.

Project-scope installs must be run from inside a git working tree. Skills are always user-wide; --project only affects hooks.

Daemon

kapacitor daemon start                   # foreground (default --name = OS username)
kapacitor daemon start -d                # background
kapacitor daemon start --name laptop -d
kapacitor daemon status
kapacitor daemon status --name laptop
kapacitor daemon stop --name laptop
kapacitor daemon stop --yes              # stop all, no prompt
kapacitor daemon doctor                  # diagnose lock-file state
kapacitor daemon doctor --clean          # also remove stale lock/pid files

kapacitor repos                          # list known repos
kapacitor repos add .
kapacitor repos remove ~/dev/old

More: Hosted agents.

Configuration and profiles

kapacitor config show
kapacitor config set <key> <value>

kapacitor profile add work --server-url https://acme.kapacitor.ai
kapacitor profile list
kapacitor profile show work
kapacitor profile remove work

kapacitor use work                       # bind 'work' to current repo
kapacitor use work --global              # set as global default
kapacitor use work --save                # write .kapacitor.json (team-share)

More: Configuration & profiles.

Other

kapacitor update                         # check npm for a newer release

The CLI checks for updates lazily (24-hour cache). To force a check, just run kapacitor update.