agent

kcap agent [ls] [--daemon <name>]
kcap agent start claude|codex [--worktree] [--private] [-d] [--daemon <name>] [-- <vendor args>]
kcap agent attach <id> [--daemon <name>]
kcap agent stop <id> [--force] [--daemon <name>]
kcap agent stop --all [--yes] [--force] [--daemon <name>]

start needs a configured server and starts the daemon if it is not running. Without --worktree the agent runs in your current directory; with it, in a throwaway worktree under .capacitor/worktrees/. --private skips registration in the web app and answers permissions in the terminal; sessions are still stored. Everything after -- goes to the vendor CLI. Detach with Ctrl-Q then d. Agent ids accept a unique prefix. attach on a review or flow agent is read-only; stop on one needs --force, which leaves the flow without that participant