mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-24 16:02:32 +00:00
l0ng-ai
fed4aec170
Every placeholder frame in docs/ now shows a real capture of the current build: 20 screenshots plus two short looping clips (prompt editor, pane drag). The README and the docs home page link a one-minute tour covering agent status across repos, one agent driving another through the CLI, the prompt editor, diffs, pane dragging, and sessions surviving a quit.
57 lines
1.8 KiB
Plaintext
57 lines
1.8 KiB
Plaintext
---
|
|
title: "Worktrees"
|
|
description: "An isolated checkout on a fresh branch, in one dialog and one tab."
|
|
---
|
|
|
|
Running two agents on the same repository at once means they fight over the
|
|
working tree. A git worktree is the fix, and tty7 makes it a single dialog.
|
|
|
|
## Creating one
|
|
|
|
**New Worktree Tab…** — in the command palette, the tab's right-click menu, and
|
|
the application menu — asks three things:
|
|
|
|
| Field | Default |
|
|
|---|---|
|
|
| **Worktree Name** | A fresh name that does not collide with an existing branch or directory |
|
|
| **New Branch** | The same name, editable |
|
|
| **Start From** | The branch you are currently on |
|
|
|
|
Each field opens on a suggestion you can accept or type straight over.
|
|
|
|
<Frame caption="The New Worktree Tab dialog, every field pre-filled">
|
|
<img src="/images/new-worktree.webp" alt="Creating a worktree" />
|
|
</Frame>
|
|
|
|
Confirm and tty7 creates the worktree, opens a tab in it, and starts a shell
|
|
there. The [sidebar](/window/sidebar) files it under the same repository group as
|
|
its parent, on its own branch.
|
|
|
|
## Where they go
|
|
|
|
Worktrees land inside the repository, under:
|
|
|
|
```
|
|
<repo>/.tty7/worktrees/<name>
|
|
```
|
|
|
|
`<repo>/.tty7/.gitignore` is created with `*` in it the first time, so the
|
|
directory never shows up as an untracked mess in your own repository.
|
|
|
|
## Removing one
|
|
|
|
Closing a worktree tab offers to remove the worktree with it:
|
|
|
|
- **Clean tree** — *Remove Worktree* or *Keep*.
|
|
- **Dirty tree** — the dialog says so, and removing requires the explicit
|
|
*Discard Changes & Remove*.
|
|
|
|
Nothing is removed silently, and *Keep* leaves the worktree on disk for `git
|
|
worktree list` to find later.
|
|
|
|
<Tip>
|
|
Pair this with [agent sessions](/agents/sessions): a worktree per agent means
|
|
two Claude Codes can work on the same repository without stepping on each
|
|
other's files.
|
|
</Tip>
|