Run

One command, every CLI. agents run <profile> "..." resolves the profile, syncs the merged config, and launches the agent.

The shape

agents run claude "refactor the queue worker"
agents run codex  "fix the failing test in src/payments/"
agents run kimi   "draft a release note for v1.20"

Common flags: --rotate picks the least-used account, --quiet suppresses the rotation banner, --stream emits stream-json for piping into another agents run.

Coming soon

Full reference — every flag, every harness, output formats, exit codes. For now see agents run --help.

Related: Pin versions, Rotate accounts, Sessions.