Agents: add, remove, refresh

Wire repowise into Claude Code, Codex, Cursor, VS Code, OpenCode, or Hermes, or drop the config snippet for anything else.

repowise init wires up detected agents as part of a first run. This group is for everything that comes after: adding an agent you installed later, removing one, refreshing configs after an upgrade, or printing a snippet for a host repowise doesn't write files for. What an agent gets once it is wired up is on MCP tools, and the Claude Code and Codex bundles are on Agent plugins. For the setup story per agent, see For AI agents.

`repowise agents`

With no subcommand, lists every known agent for the current repo: its support tier, whether it looks installed, and everywhere it's currently wired to repowise.

repowise agents [OPTIONS]

Parameter	Type	Default	Description
`--format`	string	table	Output format. json reports the full per-agent detection payload.

`repowise agents add`

Wire one or more agents up to this repo.

repowise agents add [PATH] [OPTIONS]

Parameter	Type	Default	Description
`--target`	string	—	Comma-separated agent ids, or one of: auto, all, none. Prompts when omitted.
`--scope`	string	both	Where to write: project, user, or both.
`--yes / -y`	boolean	false	Never prompt.
`--format`	string	table	Output format. json reports every file and what happened to it.

repowise agents add                            # checklist, installed agents pre-ticked
repowise agents add --target=claude-code
repowise agents add --target=claude-code,cursor --scope project
repowise agents add --target=auto --yes        # everything already detected, non-interactive

The known agent ids: claude-code, codex, cursor, vscode, opencode, hermes. --target=auto picks everything already detected. With no --target on a terminal you get a checklist with installed agents pre-ticked.

`repowise agents remove`

Remove repowise from one or more agents. --target is required, there's no default for a destructive verb.

repowise agents remove [PATH] --target TARGET [OPTIONS]

Parameter	Type	Default	Description
`--target`required	string	—	Comma-separated agent ids, or one of: auto, all, none. Required.
`--scope`	string	both	Where to remove from: project, user, or both.
`--format`	string	table	Output format. json reports every file and what happened to it.

repowise agents remove --target=cursor
repowise agents remove --target=all --scope user

`repowise agents refresh`

Rewrite the configs of agents that are already wired up. Never adds an agent, this is what to run after upgrading repowise or moving the repo: it repoints what exists and leaves everything else alone.

repowise agents refresh [PATH] [OPTIONS]

Parameter	Type	Default	Description
`--scope`	string	both	Which scope to refresh: project, user, or both.
`--format`	string	table	Output format. json reports every file and what happened to it.

repowise agents refresh

This is what repowise doctor --repair calls to fix agent config drift, so it's safe to add nothing.

`repowise agents print-config`

Print the config snippet for an agent, writing nothing. This is the whole of the paste-config tier: an agent nobody has wired up support for is still served by a snippet and a docs link.

repowise agents print-config TARGET_ID [PATH] [OPTIONS]

Parameter	Type	Default	Description
`--scope`	string	project	Which scope's snippet to print: project or user.
`--format`	string	table	Output format. table prints the bare snippet, ready to paste.

repowise agents print-config claude-code
repowise agents print-config cursor --scope user > cursor-mcp.json