# Quickstart

> Run one task from a new worktree to a commit, and the keys to get around.

<Steps>

### Open a project

Press <Kbd>⌘</Kbd> <Kbd>O</Kbd> and pick a git repository.

### Create a worktree

Press <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>N</Kbd>, enter a branch name, and confirm.

### Launch an agent

Press <Kbd>⌘</Kbd> <Kbd>N</Kbd>, 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:

- <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>E</Kbd> opens the file explorer.
- <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>F</Kbd> searches the project.
- <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>G</Kbd> lists what changed; click a file for its diff.

Select lines in a file or diff and press <Kbd>⌘</Kbd> <Kbd>I</Kbd> to leave a comment for the agent.

### Commit

Stage the files, write a message, and press <Kbd>⌘</Kbd> <Kbd>↵</Kbd>.

</Steps>

## Get around

Pickers jump straight to what you name. Cycle keys step to the next or previous one.

| Action                              | Shortcut                                              |
| ----------------------------------- | ----------------------------------------------------- |
| Open a file                         | <Kbd>⌘</Kbd> <Kbd>P</Kbd>                             |
| Run a command                       | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>P</Kbd>                |
| Switch worktrees                    | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>W</Kbd>                |
| Switch agent sessions               | <Kbd>⌘</Kbd> <Kbd>E</Kbd>                             |
| Show files / search / changes       | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>E</Kbd> / <Kbd>F</Kbd> / <Kbd>G</Kbd> |
| Toggle the sidebar / right dock     | <Kbd>⌘</Kbd> <Kbd>B</Kbd> / <Kbd>⌘</Kbd> <Kbd>R</Kbd> |
| Toggle the floating terminal        | <Kbd>⌘</Kbd> <Kbd>J</Kbd>                             |
| Cycle worktrees                     | <Kbd>⌘</Kbd> <Kbd>`</Kbd> / <Kbd>⌘</Kbd> <Kbd>~</Kbd> |
| Cycle agents in the worktree        | <Kbd>⌃</Kbd> <Kbd>`</Kbd> / <Kbd>⌃</Kbd> <Kbd>~</Kbd> |
| Cycle tabs                          | <Kbd>⌃</Kbd> <Kbd>Tab</Kbd> / <Kbd>⌃</Kbd> <Kbd>⇧</Kbd> <Kbd>Tab</Kbd> |
| Go back / forward                   | <Kbd>⌃</Kbd> <Kbd>-</Kbd> / <Kbd>⌃</Kbd> <Kbd>⇧</Kbd> <Kbd>-</Kbd> |

See [Keyboard shortcuts](/docs/customize/keyboard-shortcuts) for the full list.
