bluegardenproject

Tracks — Git skill for Claude Code

Git community

Run multiple Claude Code agents in parallel over isolated git worktrees, coordinated from a single tmux session.

How to install Tracks

This entry records only its repository, not the path inside it, so there is no exact command to give. Open bluegardenproject/tracks and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tracks does

Run multiple Claude Code agents in parallel over isolated git worktrees, coordinated from a single tmux session.

Alternatives in Git

Git Worktree Setup — Create isolated git worktrees with instant feedback and background Rust verification 25.5k ★
Worktree Parallel Init — Create multiple git worktrees for parallel development: $ARGUMENTS 23.4k ★
Parallel Workflows — Parallel Workflows with Git Worktrees 1.1k ★

README

tracks

Run multiple [Claude Code](https://docs.claude.com/en/docs/claude-code) agents in parallel, each in its own git worktree, coordinated from a single tmux session. Your editor's branch never moves while Claude is working.

Install

curl -fsSL https://raw.githubusercontent.com/bluegardenproject/tracks/main/scripts/install.sh | bash

Downloads the matching binary from the latest release into `~/.tracks` and adds it to your `PATH`, after checking it against the `SHA256SUMS` published with the release. If it can't verify the download — no checksums file, no digest tool, or a mismatch — it installs no binary and exits non-zero. Re-run it any time to upgrade — a daemon from the previous version restarts automatically on the next `tracks` run. Uninstall with [`scripts/uninstall.sh`](scripts/uninstall.sh).

To upgrade later without leaving the session, use **Check for updates** in the menu (or `tracks update`; `tracks update --check` only reports). It swaps the binary in place and leaves whatever is running alone — the daemon and open windows stay on the old binary until the next `tracks` run restarts the daemon to match, which interrupts any track still going (**Reopen** brings those back).

Requires `git`, `tmux`, and the `claude` CLI on `PATH`. Linux and macOS only.

From source

make install   # builds with Go 1.25 → ~/bin/tracks

Tracks v2 is in development in the same repo ([plan](docs/v2/masterplan.md)). `make dev && ./tracks --new-app` runs it next to an installed tracks without touching it.

Use

tracks

Starts the tmux session, launches the dashboard, brings up the daemon.

Inside the session, press `+t` to open the menu:

New track — pick a track type, then repos → slug → model → task prompt. A Work track spawns Claude in a fresh worktree on /; the slug is derived from the task prompt (a Jira-style ticket like ABC-123 becomes the prefix, followed by the first few