Skip to content
git-watchtower

Keep up with your
AI coding agents.

Monitor git branches in real-time with activity sparklines, instant notifications, and a web dashboard. Built for teams working with
Claude Code, Codex, and other AI agents.
Install via npm
9,701downloads in the last 30 days

Quick Start

View on GitHub

View on NPM

Why Git Watchtower?

Section titled “Why Git Watchtower?”

When you’re using AI coding agents on the web — Claude Code, OpenAI Codex, and others — they create branches and push commits while you’re not looking. You end up with multiple branches to check on and no easy way to know when they’ve been updated or what changed.

Git Watchtower watches your remote and notifies you when branches are updated. Preview what changed, switch with a keypress, undo if needed.

Git Watchtower terminal UI showing branch monitoring with sparklines

Features

Section titled “Features”

Live Branch Monitoring

Know instantly when a branch gets new commits. Ahead/behind counters, status badges, and activity sparklines show you what changed at a glance.

Web Dashboard

Full browser-based dashboard with PR workflows, CI status, and session statistics. Launch with --web and manage everything without touching the terminal.

Instant Notifications

Audio and visual alerts the moment a branch updates. Never miss an AI agent finishing its work.

Quick Branch Switching

Switch branches with a single keypress. Preview commits and changed files first. Undo if you don’t like what you see.

Auto-Pull

Your current branch stays up to date automatically. Remote changes get pulled without you lifting a finger.

Zero Dependencies

Built entirely on Node.js built-ins. No dependency tree. Installs in seconds.

Web Dashboard

Section titled “Web Dashboard”

Launch a browser-based dashboard alongside the terminal UI:

Terminal window
git-watchtower --web
Git Watchtower web dashboard showing branch management and PR workflows

The web dashboard provides real-time branch monitoring, PR workflows, CI status, session statistics, and more. When running multiple instances across different projects, they coordinate automatically into a single multi-project dashboard.

Built-in Dev Server

Section titled “Built-in Dev Server”

Run a static file server with live reload, or wrap your own dev server command (Next.js, Vite, Nuxt, etc.) — all while monitoring branches.

Terminal window
# Static site with live reload (default)
git-watchtower


# Wrap your own dev server
git-watchtower --mode command -c "npm run dev"


# Branch monitoring only
git-watchtower --no-server

Quick Start

Section titled “Quick Start”
Terminal window
# Install globally
npm install -g git-watchtower


# Navigate to any git repo and run
cd your-project
git-watchtower


# Or run directly with npx
npx git-watchtower

On first run, you’ll be guided through a configuration wizard.

Read the full documentation