Quick start
From a fresh install to a worktree with a running agent, in three steps.
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#
Press Ctrl+Shift+A to open New session. Write what the agent should do, or link an issue, pick where it works (a new branch, or the worktree you just created), and press Enter. Tegment opens a terminal there and starts the agent you've set as the default under Settings → Agents.
Prefer to do it by hand? Open a terminal in the worktree (one is already there after creation) and start any agent yourself:
$ 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 F5.