Install
brew install m4ttheweric/tap/rt
rt setup status # confirms the tray app, daemon, and integrations are healthy
rt setup status and rt verify both health-check the tray app, daemon, editor extensions, and shell integration so you can confirm the install is in good shape. Run rt setup plan beforehand to see the readiness checklist for what Install still needs from you.
Then configure your API tokens:
rt settings linear token # Linear API key (for ticket lookup)
rt settings gitlab token # GitLab PAT (for MR status)
See rt settings linear token and rt settings gitlab token for details.
For detailed diagnostics at any time:
rt verify
What Gets Installed
| Component | Description |
|---|---|
rt binary | Shipped inside mattstack.app (Contents/MacOS/rt), linked onto your PATH |
mattstack.app | Menu bar app... daemon health, notifications, auto-updates |
rt-context extension | VS Code/Cursor... branch + ticket in status bar |
| Background daemon | Caches MR/branch data, scans ports, guards git hooks |
| Bundled helpers | fzf, jq, gh, glab, bun, node, fast-browser — pinned and shipped inside the app, not installed onto your system |
| Shell alias | rtcd... fast worktree directory switching |
Upgrade
rt update
rt update asks mattstack.app (Sparkle) to check for an update — the app owns the whole upgrade lifecycle (signature verification, staged install, restart); rt never downloads or installs its own updates. If the app isn't running, rt update points you at the latest release instead.