Name: Watchfire
Author: Watchfire

watchfire status prints a snapshot of the current project — active agent sessions, task queue counts, and the last few lines of every running PTY.

Show current project status including active agents, task progress, and daemon connection.

Usage

watchfire status

Description

watchfire status displays a summary of the current project's state. It connects to the daemon and reports on active agent sessions, task progress, and connection details.

Output

The status output includes:

Field	Description
Project name	Name of the current project
Daemon connection	Whether the daemon is running and reachable
Active agents	Currently running agent sessions for this project, including which backend (e.g. `claude-code`, `codex`, `opencode`, `gemini`, `copilot`) each session is using
Task summary	Count of tasks by status (draft, ready, done)

Notes

Requires being inside a Watchfire project directory
The daemon must be running to retrieve full status information
For daemon-specific status (host, port, PID, uptime), use watchfire daemon status

Examples

Quick check on the current project

watchfire status

Sample output:

project: my-project
daemon:  connected (127.0.0.1:37291)
agents:
  - task 3 — claude-code (5m running)
tasks:   2 draft, 4 ready, 12 done

The agents block lists the backend each active session is using — useful for confirming a task picked up the agent you expected.

Status across all projects

watchfire daemon status

watchfire status is project-scoped (current directory). For a daemon-wide view including total active sessions, fall through to watchfire daemon status or open the Beacon dashboard in the GUI.

Common pitfalls

connection refused outside a project — watchfire status errors when the cwd isn't a Watchfire-initialised project. Fix: cd into the project root, or initialise it with watchfire init.
Daemon not running — output reports daemon: not connected and the agents/tasks sections are empty. Fix: see CLI/TUI can't connect to daemon.
Status doesn't show a "running" task — Watchfire has no running task state, only draft/ready/done; an in-flight task still shows as ready until it completes. Fix: check the agents block for which task is actually being worked on, or open the TUI/GUI for live progress.

watchfire status