run

# Run Skill Dispatch a single agent for a one-off task. `agents run` is the fundamental command for interactive sessions and headless automation across Claude, Codex, Gemini, Cursor, OpenCode, and OpenClaw. ## Headless vs interactive Explicit flags are definitive; otherwise the mode is inferred from prompt presence: - `--interactive` (`-i`) → always interactive, even with a prompt (the prompt is forwarded as the first message). - `--headless` → always headless, even with no prompt (the prompt is read from stdin). - Neither flag, **prompt provided** → headless. Pipes stdout, no TTY, exits when the agent finishes. - Neither flag, **prompt omitted** → interactive. Launches the agent's TUI with full stdio inheritance. `--interactive` and `--headless` are mutually exclusive — passing both errors out. ```bash # Interactive (TUI) agents run claude # Headless one-shot agents run claude "summarize recent git commits" ``` ## Modes Permission mode controls what the agent can do. | Mode | What it allows | |------|----------------| | `plan` (default) | Read-only — research, audit, analysis. No writes, no shell side-effects. | | `edit` | Read + write files; prompts for shell / risky operations | | `auto` | Harness-native automatic approval: Claude/Copilot use the smart classifier; Droid uses `--auto high`; Kimi uses `--auto` interactively, while headless `-p` already auto-approves and emits no mode flag. | | `skip` | Last-resort bypass of every permission prompt. Direct exec uses...