/run-agent

name: run-agent
description: >
  Launch and supervise Claude Code or Codex through the CCAM Run API. Use when
  the user wants to start a monitored agent, select a model, approval policy,
  sandbox, or working directory, send a follow-up, inspect live output, resume
  a native session, or stop a dashboard-launched run.

Run Agent

Use `ccam run` against the local dashboard.

Workflow

1. Verify the provider binary:

• `ccam run binary claude`
• `ccam run binary codex`

2. Discover supported models with `ccam run models <provider>`. 3. Confirm the working directory with `ccam run cwds`. 4. Show the exact launch settings before starting. Include provider, prompt, working directory, model, approval mode, sandbox, and resume session ID. 5. Start only after user confirmation:

ccam run start --provider codex --cwd /path/to/repo \
  --prompt "Review the current changes" \
  --permission on-request --sandbox workspace-write --yes

6. Inspect with `ccam run list` or `ccam run get <id> --envelopes`. 7. Send follow-ups with `ccam run send <id> --text "..." --provider codex --yes`. 8. Stop with `ccam run stop <id> --yes`.

Safety

• Never use `danger-full-access` unless the user explicitly requests it.
• Do not start, message, or stop a run without confirmation.
• Preserve the provider used to start the run when sending messages.
• Treat run history as evidence. Do not claim completion from process status

alone when the final output or persisted session shows an error.