watchfire update
watchfire update self-upgrades the daemon, CLI, and TUI to the latest GitHub release — checksum-verified, with rollback if the new binary fails to start.
Self-update Watchfire by downloading the latest release from GitHub.
Usage
watchfire update
Description
watchfire update checks for and installs the latest version of Watchfire. It queries the GitHub Releases API, downloads architecture-specific binaries, and replaces the current installation.
What It Does
- Queries the GitHub Releases API for the latest version
- Downloads architecture-specific binaries (CLI and daemon)
- Stops the daemon if it's currently running
- Atomically replaces the CLI (
watchfire) and daemon (watchfired) binaries - Restarts the daemon
Notes
- Requires network access to reach GitHub Releases
- The daemon is automatically stopped and restarted during the update
- Both the CLI and daemon binaries are updated together
- The GUI application updates separately via its built-in
electron-updater
Examples
Update to the latest release
watchfire update
Stops the daemon if it's running, atomically swaps both the watchfire CLI and watchfired daemon binaries, then restarts the daemon. The GUI updates separately via its built-in electron-updater.
Verify the version after updating
watchfire version
Run before and after watchfire update to confirm the new release was actually applied. If the version is unchanged, fall through to watchfire update failure.
Common pitfalls
- Permission denied on binary swap — the update fails on a path the current process can't overwrite (typically
/usr/local/bin/). Fix: re-run with the right permissions, or fall back to a source install — see Installation → Build from Source. - Daemon does not restart cleanly — the CLI is updated but
watchfire daemon statusreports the daemon is down. Fix: runwatchfire daemon startmanually, orrm ~/.watchfire/daemon.yamlif a stale connection-info file is in the way. - GUI still shows the old version —
watchfire updateonly updates the CLI/daemon. Fix: theWatchfire.appbundle has its own auto-updater; install the latest.dmg/.AppImagefrom GitHub Releases if it hasn't picked up the update yet.
watchfire metrics
watchfire metrics inspects and backfills the per-task metric records that power Beacon — duration, exit code, prompt size, and project rollups.
How Watchfire compares
Honest comparison of Watchfire to Aider, Cursor agents, raw Claude Code, GitHub Copilot Workspace, and Devin-style autonomous agents — what each is for.