Quick start

From a fresh install to a worktree with a running agent, in three steps.

Last updated Jun 18, 2026

From a fresh install to a worktree with a running agent, in three steps.

1. Add a project#

Open Tegment, choose Add project, and either browse to a local git clone or clone a repository straight from GitHub. The project appears in the tab strip, and Tegment reads its branches, status, and (if you've connected them) its GitHub and Jira issues.

2. Create a worktree#

Open the new-worktree dialog from the worktree list. Pick an existing branch, or create a new branch and choose the base branch to fork from. Tegment:

adds a git worktree in its own folder (by default <repo>.worktrees/<branch> next to your clone),
runs any post-creation commands you've configured (for example npm install),
and opens a terminal pane in the new directory.

3. Launch an agent#

Select the worktree and press Ctrl+Shift+A, or click its launch button (shown as Launch [your agent], for example "Launch Claude Code"). Tegment opens a terminal in the worktree and starts the agent you've set as the default under Settings → AI Agents.

Prefer to do it by hand? Open a terminal in the worktree (one is already there after creation) and start any agent yourself:

terminal · in the worktreesh

$ claude

Either way, an agent started in a Tegment terminal automatically knows which worktree it's in. If you've set up the MCP server, it can call back into Tegment to list worktrees, read issues, and start your app, scoped to exactly this worktree.

To start the app itself rather than an agent, define a build & run config and launch it with Ctrl+Shift+R.