Santree

Santree

npm version npm downloads license GitHub stars

Pick an issue, work on it with Claude in an isolated worktree, ship a PR — without leaving your terminal.

Get started → 5-minute tour


What’s inside

  • Interactive dashboard — every assigned issue in one TUI, with live worktree / PR / CI / review state and the running Claude session per branch.
  • Pluggable issue trackers — Linear (OAuth + GraphQL) and GitHub Issues (via gh) are first-class. Pick one per repo with santree issue switch.
  • Pluggable terminal multiplexers — auto-detects tmux or cmux; falls back gracefully when neither is active.
  • AI in the loop — Claude is launched with the rendered ticket + your context. PR creation, review fix-up, and self-review all run the agent with the right inputs pre-staged.
  • Inline diff overlay — review your branch the way GitHub does (merge-base scoped) without leaving the dashboard. Pipe through delta for syntax highlighting.

60-second tour

# Install
npm install -g santree

# Wire up shell integration (one-time)
eval "$(santree helpers shell-init zsh)"   # or bash

# Verify
santree doctor

# Open the dashboard — manage everything from one screen
santree dashboard

That’s it. Walk a real session in Quickstart.


Where to next

If you want to… Go to
Install and verify Installation
See it work end-to-end Quickstart
Understand the mental model Concepts
See the full workflow diagram Workflow
Tour the dashboard Dashboard
Look up a command Commands
Wire up Linear or GitHub Issues Trackers
Configure env vars / init scripts Configuration
Add Claude statusline / hooks / English Tutor Integrations
Compare to alternatives Why santree?
Hack on santree Development
Troubleshoot FAQ