Changelog
Full release notes — including diff stats and links to PRs — live on the GitHub Releases page.
This page is a curated highlight reel.
Recent highlights
0.7.x (May–June 2026)
santree config— one command to inspect and configure santree, replacing the separatedoctor,setup, andtrackercommands. It’s a live panel: read-only diagnostics (tool versions, update-available) sit alongside settings you can change in place — each row applies the moment you toggle it. Pick your issue tracker (Local / Linear / GitHub, with Linear OAuth inline) right inside it.santree config --checkprints the old flat status report for scripts/CI;--yesapplies recommended defaults non-interactively;--dry-runpreviews.- Optimistic PR creation — after you create a PR from the dashboard, its “Open PR” action appears immediately (with a “loading checks & reviews…” hint) instead of waiting for the next refresh. Only the just-created PR shows the loading state; existing PRs keep their info.
- Shell integration removed — santree is now a plain binary with no
santreeshell function, alias, or hook (sowhich santreejust works). Worktree create/switch from the CLI print acdcommand to copy; the dashboard with tmux/cmux opens a new window in the worktree as before. If you hadeval "$(santree helpers shell-init …)"in your shell config, you can delete that line. santree setup— a guided wizard that fixes whatsantree doctorreports: a checklist of only the steps that still need doing (diff tool +brew install git-delta, editor, Claude Code statusline / hooks / remote control, GitHub CLI auth, and per-repo.santreescaffold /.gitignore/ issue-tracker setup). Space to toggle, Enter to apply;--dry-runto preview,--yesto apply recommended defaults.- Triage tab — when Linear is the active tracker, the dashboard leads with a Triage inbox: the triage-state issues assigned to you, ordered by an urgency-coded
SLAcountdown badge (snoozed issues greyed and parked at the bottom), the full comment thread in the detail pane,ato ask Claude a read-only clarifying question about the issue,wto send it to a tree, andsto view your team’s triage on-call rotation. - Tabs split into four — Triage (Linear only) · Issues (backlog) · Trees (worktrees in progress) · Reviews (PRs awaiting your review).
- Non-blocking worktree deletion — confirm
dand removal runs in the background with staged progress; fire several in a row without waiting. - PR draft/ready toggle, browser PR compose pre-fill, and dashboard auto-refresh throttled to 5 minutes.
0.6.x (May 2026)
- Reviews tab —
[v]opens the PR diff inline (parsed fromgh pr diff), now withSANTREE_DIFF_TOOLsyntax highlighting in parity with the worktree diff overlay. - Dashboard
?help overlay — press anywhere to see the glyph legend + key reference. - Dashboard “Tasks” section — live Claude todo list for the active worktree session.
- Commit
--fill— draft commit messages via Claude. Dashboard[C]flow gained a choose-mode (fill / manual) step. - Dashboard “Main repo” synthetic row — surfaces the parent repo’s branch + commits-behind alongside worktree rows.
- View PR diffs from the Reviews tab —
[v]works for PRs without local worktrees too (usesgh pr diff). - Squirrel SDF loader — replaces the previous donut/cube loaders. (Standalone via
santree helpers squirrel.)
0.5.x
- Multiplexer abstraction — auto-detects tmux / cmux. The
SANTREE_MULTIPLEXERenv var was removed in favour of pure auto-detection. - Centralized issue tracking + multiplexer logic; cleaner
lib/trackers/andlib/multiplexer/. - Delta integration —
SANTREE_DIFF_TOOL=deltafor syntax highlighting in the diff overlay;splitCombinedSgr()works around an upstreamslice-ansibug. - Linear OAuth PKCE flow + GraphQL ticket fetching.
- GitHub Issues tracker — full parity with Linear via the
ghCLI.
0.4.x and earlier
See GitHub Releases for the full history.
Versioning
Santree follows SemVer with a relaxed major-zero convention:
- Patch (
0.x.Y→0.x.Y+1) — bug fixes, minor polish - Minor (
0.X.y→0.X+1.0) — new features, possibly breaking - Major (
X.y.z→X+1.0.0) — reserved for the 1.0 GA
While we’re at 0.x, expect occasional breaking changes in minor releases — they’ll always be called out in the release notes.
Update notifications
santree config --check and the dashboard banner check npm for newer versions (cached for 6 hours per package). Run santree update to upgrade — it auto-detects your package manager (npm / pnpm / yarn / bun).