Git and worktrees
Git in the sidebar
Section titled “Git in the sidebar”Each chat row shows:
- The branch, worktree or detached name. Names over 22 characters are shortened in the middle; hover for the full name.
- How many files changed.
- Ahead and behind counts.
- A dimmed “removed” note if its worktree no longer exists.
Click a row’s Git status to select that chat and open its Changes panel.
Worktrees
Section titled “Worktrees”A worktree is a nested group under its project. It holds every chat whose folder is inside it. Chats in the main checkout stay at the project’s top level. Empty worktrees are hidden.
Create one
Section titled “Create one”Arm New worktree in the composer before you send. On the first send Aether:
- Creates a branch named
aether/<slug>, with the slug taken from your prompt (up to 48 characters). - Creates the worktree folder from the base you picked.
- Starts the chat’s CLI there.
It never reuses an existing branch or folder. If creation fails, the error stays above the composer until you dismiss it, and cancelling leaves no stray branch behind.
Share one
Section titled “Share one”The same toggle lists existing worktrees. Pick one to run a second chat in it. Agents and worktrees are not forced one to one.
Remove one
Section titled “Remove one”Removing a worktree offers to delete its folder and, optionally, its branch. Aether refuses if the worktree has uncommitted changes, unmerged work or a lock, and says when a forced removal is needed. It never prunes other worktrees. Worktrees are never deleted automatically.
The Changes panel
Section titled “The Changes panel”⌘⇧G on macOS, CtrlShiftG on Linux.
- Stage and unstage files.
- Read the diff.
- Write a commit message (each folder keeps its own draft) and commit with ⌘Enter.
- Push.
Branch picker
Section titled “Branch picker”The branch and worktree selector switches a chat’s branch or worktree with the keyboard: arrows to move, Enter to pick, Esc to close.