orchard

🌳 orchard

A keyboard-driven terminal dashboard for your local git repositories. See every repo's branch, dirty / ahead / behind state, language, and last commit on one screen, then pull, fetch, switch branches, search, or open them in your editor, browser, or Claude Code.

Built with Bubble Tea and Lipgloss.

Tip: run orchard preview to print one frame of the dashboard to stdout.

Why orchard

Plenty of tools already show many git repos at once (gita and mani on the CLI; gitpane, git-dash, and git-scope as TUIs), and plenty of tools read your Claude Code transcripts for usage stats (ccusage and friends). orchard is the one that puts both in the same window: an interactive multi-repo git dashboard that also knows where you have been running Claude Code, launches it in any repo, and searches code across every repo at once.

If you juggle many repositories and lean on Claude Code, orchard is the cockpit for that workflow. If you only ever work in one repo at a time, a single-repo TUI like lazygit will serve you better.

Features

• One-screen overview of every repo: branch, clean/dirty/ahead/behind/diverged/detached, uncommitted + stash counts, dominant language, last-synced and last-commit times (color-coded by freshness).
• Safe bulk pull - fast-forward only; skips dirty repos, detached HEADs, non-default branches, and repos with no upstream.
• Fetch, branch switch, multi-select - act on one repo or many at once.
• Open anywhere - launch your editor (e), the repo in your browser (O), or Claude Code (c) in a new terminal tab; multi-repo actions ask for confirmation first.
• Cross-repo code search (S) that respects .gitignore.
• Worklog (L) - your own commits across all repos in a time window.
• Clone (+) a new repo into the dashboard, or orchard clone a scoped GitHub org.
• Claude Code aware - usage panel, a per-repo activity column, launch/resume/cross-repo sessions, and a flag for uncommitted AI work. See Claude Code below.
• Scriptable CLI - scan, pull, clone with --json for cron and pipelines.

Claude Code

orchard treats Claude Code as a first-class part of a multi-repo workflow. Everything is read locally from your ~/.claude transcripts; nothing is sent anywhere.

• Usage panel pinned under the list: total sessions, turns, repos used, last active, a model split, and your busiest repos.
• Per-repo CLAUDE column: how long ago Claude last ran in each repo, colored by recency.
• Uncommitted-work flag: when a repo is dirty and Claude ran there recently, the CLAUDE cell turns red with a !, so AI edits never get lost in an unstaged tree.
• Launch (c): open Claude Code in a new terminal tab for the selected repo(s); multi-repo asks for confirmation.
• Resume (C): continue the most recent session in the current repo (claude --continue).
• Across repos (A): one session spanning the selected repos, opened in the first with the rest attached via --add-dir, for cross-service work. space-select 2+ first.
• Sort by Claude (s): float the most recently Claude-worked repos to the top.
• Adaptive: launches $ORCHARD_AI_CMD if set, otherwise the first of claude or copilot found on your PATH.

Requirements

• Platforms: macOS and Linux (amd64/arm64). Windows is not supported yet.
• Build: Go 1.24+.
• Runtime: git on your PATH.
• Optional:
  • A Nerd Font for the icons (any other monospace font works; icons just render as boxes).
  • gh (GitHub CLI) - used by orchard clone --org for auth if GITHUB_TOKEN isn't set.
  • claude - for the c key (launch Claude Code) and the usage panel.
  • A supported terminal for new-tab launches: Ghostty, iTerm2, WezTerm, tmux, or macOS Terminal (otherwise it falls back to running in place).

Install

Download a release (no Go required)

Grab the archive for your OS/arch from the Releases page, extract it, and move the orchard binary onto your PATH:

# e.g. macOS Apple Silicon - adjust the filename for your OS/arch
tar -xzf orchard_*_darwin_arm64.tar.gz
sudo mv orchard /usr/local/bin/
orchard version

On macOS the binary is unsigned, so the first launch may be blocked by Gatekeeper. Allow it once with:

xattr -d com.apple.quarantine /usr/local/bin/orchard    # or right-click → Open

go install (needs the Go toolchain)

go install github.com/prakashkurup/orchard@latest

From source

git clone https://github.com/prakashkurup/orchard.git
cd orchard
make build       # produces ./orchard (version stamped from git tags)
make install     # installs into $(go env GOPATH)/bin

Quick start

orchard                               # launch the TUI for the configured root
orchard --root ~/Documents/GitHub     # or point it at any folder
orchard preview                       # render one dashboard frame to stdout
orchard scan --root ~/code --json     # machine-readable status of every repo
orchard pull --root ~/code --all      # fast-forward every eligible repo

orchard scans one root folder and treats each immediate subdirectory that contains a .git as a repository. (If the root itself is a repo, it shows just that one.)

TUI keys

CLI

orchard [--config PATH]                  start the TUI
orchard [--config PATH] scan    [flags]  print repo status
orchard [--config PATH] pull    [flags]  fast-forward eligible repos
orchard [--config PATH] clone   [flags]  clone scoped GitHub org repos
orchard [--config PATH] preview [flags]  render the dashboard once
orchard [--config PATH] config           show resolved configuration
orchard [--config PATH] stats            summarize the orchard (languages, harvest)
orchard version                          print the version
orchard help

Common flags: --root PATH, --concurrency N, --json. Run orchard <cmd> -h for per-command flags.

• scan - --root, --concurrency, --json
• pull - --all or --match RE, --root, --concurrency, --json
• clone - --org and --match RE (both required, so you never clone a whole org by accident), --include-archived, --root, --concurrency, --json
• preview - --width, --height, --group, --detail NAME

Configuration

All settings are optional. Precedence: CLI flags → environment variables → config file → built-in defaults.

Environment variables

• ORCHARD_ROOT - default repo folder.
• ORCHARD_CONFIG - explicit config file path.
• GITHUB_TOKEN - token for orchard clone (falls back to gh auth token).

Config file is a small key: value format with one nested scope: section. Copy config.example.yaml to config.yaml. Search order: --config → $ORCHARD_CONFIG → ./config.yaml → next to the binary → $XDG_CONFIG_HOME/orchard/config.yaml.

root: ~/Documents/GitHub
concurrency: 8
org: your-github-org
scope:
  match: "^(service|app)-"

Security & privacy

orchard runs locally with no telemetry. The only network traffic is git talking to your remotes, plus the GitHub API when you run orchard clone.

• The GitHub token is read from GITHUB_TOKEN or gh auth token at the moment it's needed; it is never written to disk or printed.
• The Claude usage panel only reads your local ~/.claude transcript files; nothing is sent anywhere.
• Pulls are fast-forward only and skip dirty repos - orchard never force-pushes, rebases, or discards work.

See SECURITY.md for how to report a vulnerability.

Development

make build       # build ./orchard
make test        # run the test suite
make test-race   # tests with the race detector
make lint        # gofmt check + go vet
make check       # lint + test (run before committing)
make cover       # HTML coverage report
make help        # list all targets

The codebase is split into small packages under internal/ (tui, git, github, repo, config, editor, lang, search, seen, termlaunch, claude) with a thin main.go CLI. The logic lives in the unit-tested packages; the TUI is a Bubble Tea layer on top.

Cutting a release

Releases are automated with GoReleaser. Tag a commit and push the tag - the release workflow builds binaries for macOS and Linux (amd64 + arm64) and publishes them:

git tag v0.1.0
git push origin v0.1.0

Contributing

Issues and PRs are welcome. Please run make check before submitting. See CONTRIBUTING.md.

License

MIT