Docs
Spur is a native macOS workspace for parallel software work: it keeps one durable Thread per Git worktree — or several Threads sharing one directory — and runs the Pi coding agent inside each, with a read-only diff surface, history, and background updates.
Install
- Download the DMG from spur.kevin.top.
- Drag Spur to Applications and launch it.
- Updates download and install in the background; the new version activates on the next launch.
Quick start
- Add a project (⌘O or the Add project button) — a Git repository or a plain directory.
- A Git project shows one Thread per worktree. Press + on the project row to create a worktree: pick a name and a base branch (set the default base from the project's
•••menu). - A directory project starts empty; + creates a Thread. Directory Threads share the same folder — Spur runs them concurrently but does not isolate their files.
- Select a Thread and Start Pi. Add Agent opens more panes in the same Thread; each pane is its own Pi instance with its own conversation.
- Open the Changes tab for the worktree diff against
HEAD: stage, unstage, or discard whole files or single hunks, then commit the staged set. Conflicted files are flagged and excluded from commits until resolved. - Archive a finished Thread from its row menu; find and restore archived work in History.
Closing Spur ends the agent processes; on the next launch Spur resumes the panes you left open with their saved Pi conversations, so the context continues.
Keyboard
| Keys | Action |
|---|---|
| ⌘O | Add a project |
| ⌘F | Filter the sidebar |
| ⌘B | Show / hide the sidebar |
| ⌘R | Refresh projects |
| ⌘] / ⌘[ (or ⌃-arrows) | Focus the next / previous agent pane |
| ⇧⌘E | Equalize pane sizes |
| ⇧⌘W | Close the focused pane |
| ⌘C / ⌘V | Copy / paste in the terminal |
| ⌘, | Settings |
Settings
⌘, configures the Pi binary path and extra launch arguments, HTTP/HTTPS proxies for agent processes, and the editor command used by Open in Editor.
More
- Interactive UI preview — the design-state walkthrough of every screen.
- Product spec — the original design document (archive; the shipped app supersedes it where they differ).
- Changelog & downloads — release notes ship with every version.