Getting started with Tegment

Download the desktop app, add your first project, and create a worktree.

Last updated Sep 05, 2026

Tegment is a desktop control room for running coding agents in parallel. Every git branch gets its own folder and its own terminals — so you can have one agent on a checkout fix, another on a refactor, and a third on a dependency bump, without any of them stepping on each other.

That's what it's built for first — but the terminals are ordinary shells. You can run whatever you like in them: a dev server, a build, a test watcher, or just your normal git workflow. Agents are the focus, not a requirement.

If you're new, read this page in order; if you're not, the sidebar is the fastest way around.

Install#

Download Tegment for macOS or Windows from the download section on the home page. You sign in to use Tegment, and the Community edition is free. To try Pro, start a 14-day trial from your account: no card, and it ends by itself. See Installation for the per-platform details.

The setup wizard#

The first time you open Tegment, a wizard asks two questions: where the code you'll work on lives (public or private repositories), and where your tickets live (GitHub Issues, Jira, both, or neither). Everything after that follows from your answers, so you only see the steps that apply to you.

Two of those answers need Pro, and the wizard says which before you pick them: private repositories, and Jira. If you choose one, the next step offers the free 14-day trial. It's started on tegment.app in your browser, because your subscription belongs to your account rather than to the app, and the wizard notices by itself when it goes live, so you never start over. Turning it down costs you nothing: you carry on with Community and the wizard drops the steps that no longer apply.

The rest is the setup itself: connect GitHub or Jira, add your first project, turn your Jira filters into the sidebar sections you'll actually work from, keep the agents Tegment found on your machine, and pick a theme and a terminal layout. Skipping a step is fine, and the last screen tells you what's working and where in Settings to pick up anything you left.

You can run it again at any time from Settings → General → Run Setup Wizard, and every answer it takes lives in Settings afterwards.

Add a project#

Open Tegment and choose Add project. You can add one two ways:

Create your first worktree#

With a project open, start a new worktree from the worktree list. You can either check out an existing branch or create a new branch from a base branch. Tegment adds a git worktree in its own folder (next to your clone by default) and opens a terminal in it.

If you've connected GitHub or Jira, you can also create a worktree straight from an issue or pull request in the sidebar — Tegment names the branch from the issue for you. See Worktrees for the full flow.

Where to go next#

Installation