Get started
Quickstart
Run one task from a new worktree to a commit, and the keys to get around.
Open a project
Press ⌘ O and pick a git repository.
Create a worktree
Press ⌘ ⇧ N, enter a branch name, and confirm.
Launch an agent
Press ⌘ N, pick your agent, and give it the task. Its card in the sidebar shows when it is working and when it needs you.
Review the work
Read the code the agent touched:
- ⌘ ⇧ E opens the file explorer.
- ⌘ ⇧ F searches the project.
- ⌘ ⇧ G lists what changed; click a file for its diff.
Select lines in a file or diff and press ⌘ I to leave a comment for the agent.
Commit
Stage the files, write a message, and press ⌘ ↵.
Get around
Pickers jump straight to what you name. Cycle keys step to the next or previous one.
| Action | Shortcut |
|---|---|
| Open a file | ⌘ P |
| Run a command | ⌘ ⇧ P |
| Switch worktrees | ⌘ ⇧ W |
| Switch agent sessions | ⌘ E |
| Show files / search / changes | ⌘ ⇧ E / F / G |
| Toggle the sidebar / right dock | ⌘ B / ⌘ R |
| Toggle the floating terminal | ⌘ J |
| Cycle worktrees | ⌘ ` / ⌘ ~ |
| Cycle agents in the worktree | ⌃ ` / ⌃ ~ |
| Cycle tabs | ⌃ Tab / ⌃ ⇧ Tab |
| Go back / forward | ⌃ - / ⌃ ⇧ - |
See Keyboard shortcuts for the full list.