watchfire run

Run an agent session — chat mode, single task, or all ready tasks.

Usage

watchfire run [taskid|all]

Modes

Chat Mode (no arguments)

watchfire run

Starts an interactive chat session with the coding agent. The agent has access to your project but is not assigned a specific task. Equivalent to the old watchfire chat command.

Single Task

watchfire run <taskid>

Executes a specific task by its task number. The agent is spawned in an isolated git worktree on a dedicated branch (watchfire/<taskid>), with the task prompt and acceptance criteria injected into context.

When the agent marks the task as done, Watchfire automatically:

• Stops the agent session
• Merges the worktree branch (if auto-merge is enabled)
• Cleans up the worktree (if auto-delete is enabled)

All Ready Tasks

watchfire run all

Runs all tasks with status: ready sequentially. After each task completes, the next ready task is started automatically. This is equivalent to the Start All agent mode.

Flags

Flag	Description
--sandbox <backend>	Override the sandbox backend. Valid values: auto, seatbelt, landlock, bubblewrap, none.
--no-sandbox	Shorthand for --sandbox none — disables sandboxing entirely.

Sandbox priority: CLI flag → project setting (project.yaml) → global default (settings.yaml).

Agent Selection

watchfire run uses whichever backend Watchfire resolves for the session — it does not force a specific agent. Resolution order:

1. task.agent (for single-task runs, if set)
2. project.default_agent
3. Global default agent
4. claude-code

In run all mode, each task is launched independently, so tasks pinned to different backends in their own agent field will each run on their pinned backend.

See Supported Agents for the full list of backends and Projects and Tasks for the resolution rules.

Examples

# Interactive chat session
watchfire run

# Run task #3
watchfire run 3

# Run all ready tasks in sequence
watchfire run all