Projects & Worktrees
Lattis organizes everything around your git repositories. A project is a repo; the work inside it is its branches, and each branch an agent works on gets its own worktree — a separate checkout on disk — so parallel agents stay isolated.
Add a project
Section titled “Add a project”In the sidebar, choose Projects → Add project and select a local git repo. It appears in the sidebar with its branches listed beneath it. The repo’s primary checkout is marked with a star (★).
Each project has a settings screen (the gear icon) where you can, among other things, pin it to a specific cloud account.
Branches and worktrees
Section titled “Branches and worktrees”Lattis lists a project’s branches live, straight from git — there’s no separate task state to keep in sync.
- Open an existing branch to launch an agent in its worktree. If a session is already running there, Lattis reattaches to it instead of starting a duplicate.
- Create a new branch with New branch. Lattis creates the branch, adds a dedicated worktree for it (a sibling checkout on disk), and starts your default agent there.
Because each branch lives in its own worktree, several agents can work at the same time without overwriting each other’s files or fighting over the index — the whole point of running a fleet.
Working across branches
Section titled “Working across branches”Switch between branches in the sidebar at any time; running agents keep going in the background, and their stoplights keep you informed even while you’re looking at another branch. Each branch row shows its PR state, line changes, and cost inline, so the sidebar doubles as a status board for the whole project.
Cleaning up
Section titled “Cleaning up”When you’re done with a branch, its context menu offers Delete local branch (removing the worktree), and — once a PR is merged — Lattis can delete the remote branch, local branch, and worktree together as part of the merge. Merging a PR from within Lattis is worktree-aware: it won’t disturb your other checkouts.
Removing a project
Section titled “Removing a project”Settings → Projects lists every tracked project — name, path, worktree count, and whether agents are running — with two actions per row:
- Remove takes the project out of Lattis; every file stays on disk. An Undo appears right where the row was, in case you change your mind.
- Delete… erases the repository and its worktrees from disk. Before you confirm (by typing the project’s name), Lattis inventories exactly what will be deleted — the repository and each linked worktree, with sizes — and warns about uncommitted changes that would be lost and agent sessions that will be stopped.
The same two actions live on each project’s settings screen (the gear icon).
- Running Agents — launch agents in your worktrees.
- Changes & Spend — what each branch is producing and costing.