Watchfire

Watchfire orchestrates coding agent sessions based on task files. It supports Claude Code, OpenAI Codex, opencode, Gemini CLI, GitHub Copilot CLI, and Cursor Agent. The daemon runs one agent per project at a time, but coordinates many projects concurrently, spawning each session in a sandboxed PTY with git worktree isolation. Thin clients (CLI/TUI and GUI) connect over gRPC.

Components

Component	Binary	Description
Daemon	watchfired	Orchestration, PTY management, git workflows, gRPC server, system tray
CLI/TUI	watchfire	Project-scoped CLI commands + interactive TUI mode
GUI	Watchfire.app	Electron multi-project client

How It Works

1. Define your project with watchfire init and a project definition
2. Create tasks describing what you want built
3. Start agents that work in isolated git worktrees (one branch per task)
4. Monitor progress through the TUI or GUI with live terminal output
5. Review and merge completed work

The daemon watches task files for changes. When an agent marks a task as done, Watchfire automatically stops the agent, merges the worktree (if auto-merge is enabled), and chains to the next task.

Quick Example

cd your-project
watchfire init        # Initialize project & define what you're building
watchfire wildfire    # Agents generate tasks, code, and merge — autonomously

Next Steps

• Installation — Install Watchfire from source or Homebrew
• Supported Agents — Choose a backend and set up auth
• Quick Start — Get up and running in minutes
• Architecture — Understand how the pieces fit together
• Tips & Best Practices — Field guide to writing tasks, sizing work, and picking modes
• Keyboard Shortcuts — Printable cheat sheet of every TUI and GUI binding
• Troubleshooting — Common errors and copy-paste fixes
• Roadmap — Where Watchfire is heading after Forge