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

Repo folder

The setup checklist asks where rt should clone your team's repos instead of assuming a default location. You can also set this from the CLI for scripted installs:

rt setup repo-root set ~/code     # set the repo folder

Before Install (when the home repo doesn't exist yet), the answer is staged. After Install, it writes directly to the settings store. The tray app shows an OS folder picker for this step.

Agent permissions

Install seeds a baseline permissions.allow list into Claude Code's settings so agents don't stall on per-tool prompts for calls rt already trusts. The seeded entries cover glab commands, the Fast Browser plugin, EnterWorktree, the mattstack MCP server, and rt skills sync. Existing entries are preserved; only missing ones are appended.

Integration health

rt setup status warns when an integration token is approaching expiry, so you can rotate it before it breaks.

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	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

PATH

rt setup status checks that ~/.local/bin is on your PATH and that rt's own entry is present. Two distinct states:

• missing: ~/.local/bin is not on PATH at all. Run setup to fix it.
• unowned: ~/.local/bin is on PATH but rt didn't put it there (no owner attribution). This is informational, not a failure.

Finishing setup

The setup wizard gates its Finish step on one optional prerequisite: the Fast Browser extension. Without it, agents cannot capture screenshots or annotate evidence from your browser.

If Chrome is not installed, the gate is skipped automatically. Otherwise, the Done screen shows "One step left before you finish" with Finish disabled until the extension is detected.

You can skip the gate from the wizard ("Skip for now") or from the CLI:

rt setup waive tool.fast-browser-extension     # skip on this Mac
rt setup unwaive tool.fast-browser-extension   # re-arm later

In the app's Settings, the Fast Browser pane shows "Skipped on this Mac" with an Un-skip button when waived.

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.