watchfire task

Manage tasks in your Watchfire project.

Usage

watchfire task <subcommand> [arguments]

Subcommands

task add

Create a new task interactively.

watchfire task add

Opens interactive prompts to set the task title, prompt, acceptance criteria, status, and (optionally) the agent backend to run this task on. The task is saved as a YAML file in .watchfire/tasks/.

If you skip the agent prompt, the field is omitted and the task uses the project's default agent at execution time.

task list

List all tasks in the project.

watchfire task list
watchfire task ls          # alias

Displays tasks grouped by status (draft, ready, done). Soft-deleted tasks are excluded by default.

Flag	Description
--deleted	Include soft-deleted tasks in the listing

task <number>

Edit an existing task interactively.

watchfire task 1
watchfire task 3

Opens the specified task (by task number) for interactive editing. You can modify the title, prompt, acceptance criteria, status, and agent override.

task delete

Soft-delete a task.

watchfire task delete <number>
watchfire task rm <number>    # alias

Sets the deleted_at timestamp on the task. The task file is preserved but hidden from task list by default.

task restore

Restore a soft-deleted task.

watchfire task restore <number>

Clears the deleted_at timestamp, making the task visible again.

Task Agent Override

Each task YAML may include an optional agent field to pin the backend used for that task:

task_id: a1b2c3d4
task_number: 2
title: "Refactor docs search"
agent: gemini
prompt: |
  Replace the existing search index with a fuzzy matcher.
acceptance_criteria: |
  - Search returns results for partial matches
  - Existing tests pass
status: ready

When agent is omitted, Watchfire resolves the effective backend in this order:

1. task.agent
2. project.default_agent
3. Global default agent
4. claude-code

See Projects and Tasks for the full schema and Supported Agents for the available backends.

Examples

# Add a new task
watchfire task add

# List all active tasks
watchfire task list

# Edit task #2 (including its agent override)
watchfire task 2

# Delete task #5
watchfire task delete 5

# Show deleted tasks
watchfire task list --deleted

# Restore task #5
watchfire task restore 5