https://github.com/watchfire-io/watchfire
Better context. Better code.
https://github.com/watchfire-io/watchfire
ai-agents cli coding-agents git-workflow golang orchestration tui
Last synced: 28 days ago
JSON representation
Better context. Better code.
- Host: GitHub
- URL: https://github.com/watchfire-io/watchfire
- Owner: watchfire-io
- License: apache-2.0
- Created: 2026-02-04T16:33:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-25T16:18:41.000Z (about 1 month ago)
- Last Synced: 2026-03-26T05:21:35.132Z (about 1 month ago)
- Topics: ai-agents, cli, coding-agents, git-workflow, golang, orchestration, tui
- Language: Go
- Homepage: https://watchfire.io
- Size: 899 KB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-claude-code-toolkit - Watchfire
README
Better context. Better code.
AI coding agents work best when they have the right context. Watchfire lets you define your project structure, break work into well-scoped tasks, and orchestrate agents that execute with full awareness of your codebase, constraints, and goals. It manages context automatically — so agents stay on track and produce code you'd actually ship.
---
## Install
### macOS
**Homebrew** (recommended):
```bash
brew tap watchfire-io/tap
brew install --cask watchfire-io/tap/watchfire # Desktop app (GUI + CLI)
brew install watchfire-io/tap/watchfire # CLI & daemon only
```
**Script:**
```bash
curl -fsSL https://raw.githubusercontent.com/watchfire-io/watchfire/main/scripts/install.sh | bash
```
### Linux
```bash
curl -fsSL https://raw.githubusercontent.com/watchfire-io/watchfire/main/scripts/install.sh | bash
```
Homebrew also works on Linux:
```bash
brew tap watchfire-io/tap && brew install watchfire-io/tap/watchfire
```
### Windows
```powershell
irm https://raw.githubusercontent.com/watchfire-io/watchfire/main/scripts/install.ps1 | iex
```
---
## How It Works
---
## Key Features
### 🎯 Context Management
Define your project once. Watchfire feeds agents the right specs, constraints, and codebase context — no copy-pasting prompts.
### 📋 Structured Workflow
Break big projects into tasks with clear specs. Agents tackle them in order, each in an isolated git worktree branch.
### 🚀 Scale with Confidence
Run agents across multiple projects in parallel. Monitor live terminal output, review results, and merge — from TUI or GUI.
---
## Agent Modes
| Mode | Description |
|------|-------------|
| **Chat** | Interactive session with the coding agent |
| **Task** | Execute a specific task from the task list |
| **Start All** | Run all ready tasks sequentially |
| **Wildfire** | Autonomous loop: execute tasks, refine drafts, generate new tasks |
| **Generate Definition** | Auto-generate a project definition from your codebase |
| **Generate Tasks** | Auto-generate tasks from the project definition |
---
## Build from Source
```bash
# Build & install
make install-tools # Dev tools (golangci-lint, air, protoc plugins)
make build # Build daemon + CLI
make install # Install to /usr/local/bin
# Use it
cd your-project
watchfire init # Initialize a project
watchfire task add # Add tasks
watchfire # Launch the TUI
```
---
## 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 |
## Development
```bash
make dev-daemon # Daemon with hot reload
make dev-tui # Build and run TUI
make dev-gui # Electron GUI dev mode
make test # Tests with race detector
make lint # Linting
make proto # Regenerate protobuf code
```
## Architecture
See [ARCHITECTURE.md](ARCHITECTURE.md) for the full design document.
## License
Proprietary. All rights reserved.