Commands
The copillm CLI groups commands by domain. Most management commands accept --json for machine-readable output. (Agent launchers forward all non-copillm flags straight to the underlying agent.)
Global flags
| Flag | Description |
|---|---|
--debug | Enable copillm debug mode for the command. For daemon starts this enables /_debug, sets daemon logging to debug, and writes detached daemon logs to ~/.copillm/debug.log. Put this before the subcommand, e.g. copillm --debug claude. |
--no-update-notifier | Skip the npm registry update check for this run. (Also controllable via COPILLM_UPDATE_CHECK / NO_UPDATE_NOTIFIER — see environment variables.) |
Agent arguments still belong after the agent command. For example, copillm --debug claude -- --debug enables copillm debug mode and forwards --debug to Claude Code.
| Group | Description |
|---|---|
auth | Sign in, sign out, and inspect credential state. |
claude | Launch Claude Code, fully wired against the local daemon. |
codex | Launch Codex CLI, fully wired against the local daemon. |
copilot | Launch GitHub Copilot CLI with the stored GitHub token injected (no second device-flow login). |
pi | Launch the pi coding agent, fully wired against the local daemon. |
daemon | Start, stop, and inspect the background proxy daemon. |
env | Emit the environment block for manual agent wiring. |
models | List the upstream model catalogue and pin which models are advertised. |
config | Manage ~/.copillm/agent.toml — profiles, MCP servers, instructions, and yolo defaults. |
See the environment variables reference for variables that affect every command.