Getting started

This walks through n10 Desktop with a GitHub repository. It assumes you have installed n10 and its prerequisites, including a signed-in gh and claude.

1. Open your repository

Run n10 from the root of the repository you want to work on:

cd ~/code/my-project
n10

n10 Desktop opens that repository. Run it anywhere else, including a subdirectory, and it opens the repository you used last, or asks you to pick one with Open repository….

n10 reads your Git remote and fills in the project settings: the owner and repository, and your GitHub username from gh. The sidebar lists your worktrees and the open pull requests that involve you: ones you opened, are assigned to, are mentioned in or have commented on.

For Azure DevOps, open Settings with ⌘, (Ctrl+, on Linux), go to Provider and enter your personal access token.

2. Create a worktree

Press ⌘N (Ctrl+N on Linux). Type a name for the new branch, such as fix-login-timeout, and choose Create branch fix-login-timeout and open a worktree.

n10 creates the branch from the commit your main checkout is on, and checks it out in a worktree under .claude/worktrees/ in the repository. The agent works there, so your main checkout's files stay as they are. The Worktree Path setting moves worktrees elsewhere.

3. Launch an agent

When the worktree is ready, the launch dialog opens. The Agent selector starts on your default agent, Claude unless you've changed it. Leave New session selected and choose Start new session.

The agent starts in the worktree, in a terminal pane in n10. Tell it what to do, as you would in any terminal.

Agents and terminals run in tmux, so quitting n10 leaves them running, and n10 reconnects to them when you open it again. An agent that has exited keeps its last output. Claude and Codex conversations can be resumed; for other agents, start a new session.

Closing a tab is different from quitting. Closing a worktree or pull request tab stops its agent, asking first only if the agent is busy. Closing a terminal tab, or choosing Stop agent, ends that session.

To launch an agent on a worktree later, right-click it in the sidebar and choose Launch agent….

4. Follow the pull request

When the agent opens a pull request, its CI checks, reviews and conflicts show on the worktree's row. See what the sidebar shows.

Terminals and other repositories

⌘⇧T (Ctrl+Shift+T on Linux) opens a terminal: choose a shell or an agent, and the directory it starts in. To work on another repository, use Open Repository… (⌘O) or pick a recent one from the title bar. Your open tabs stay across repositories.

Next

• Review an agent's draft comments on someone else's pull request.
• Babysit a pull request so its agent hears about failing checks and new comments.
• Configure n10: choose your agent, sync interval and merged-branch cleanup.
• Prefer the terminal? See the terminal UI.