Terminals, tabs, and the keys that matter.

Projects and worktrees, tabs, splits, find, sessions that keep running, and the Git, Files, and Issues panels.

On this page

Code Mode is Brunvo's terminal workspace: your repositories and their worktrees in the sidebar, a row of tabs for each one, and each agent and shell in a terminal of its own. Press Option C to go there and Option A to go back to Agent Mode; both show the same sessions.

Projects and checkouts

The sidebar (Command B) lists what you work on. Each repository is a heading, with its checkouts under it: the main checkout and each worktree, its branch beside it. A folder that is not a repository sits among them. Under each checkout are its tabs, and under a tab of several panes, the panes. Each row starts with what its agent is doing.

  • Open a folder (Shift Command O, or the + by the sidebar's search) lists the folders and repositories in your project folders, ready to search. Pick one and it opens as a project, with a shell.
  • Click a repository, worktree, or folder to open or close it. Drag a row to put it where you want it.
  • A repository's menu (its ⋯ button or a right-click) has New Worktree…: a separate checkout on its own branch, so an agent there never edits the same files as you. A worktree of a repository your AI tools already trust is trusted the same way.
  • When a branch has a pull request, its number shows beside the branch with whether its checks pass, fail, or still run. Click it for the failing checks and the reviews.
  • Move Folder… in the same menu moves a project anywhere, agents and all (Move a folder).

Option Shift O and Option Shift P step between the projects you have open.

Tabs, splits, and zoom

Every session is a tab in the row above the terminal, led by its number: Option 1 to Option 9 go straight to one, and Shift Command [ and Shift Command ] step to the previous and next session. Option T opens a shell tab in the folder you are in; Command T opens the New Tab menu, with a shell and each of your AI tools. Option R renames a tab.

Split the terminal you are in, and the new one starts in the same folder:

  • Option V splits right and Option S splits down; Option Shift S adds a shell across the bottom.
  • Option J, Option K, Option I, and Option L move between panes. Option ← and Option → also go past the board's edge into the open sidebar or side panel.
  • Option Shift Z gives one pane the whole board, and Option Z puts the split back.
  • Option ! takes a pane out into a tab of its own; the rest of the group stays on the board.

Tabs on the board together are a group: drag a tab onto the board, beside any pane, to join them, or choose Move into Group in its menu (Option Shift V). Option X ends the pane you are in and Option Shift X the whole tab, each after you confirm.

The tab list and Tab Overview

When a project has more tabs than the row shows, three more places find them:

  • Tab Overview (Shift Command \) shows every tab of the project as a card, grouped as on the board, with its number, what its agent is doing, and its last lines. Choose one to go there.
  • Projects, Tabs, and Panes (Option Shift G) lists every open project with its tabs and their panes, the one you are in selected. Type to narrow it.
  • The sidebar keeps the same tree, and a tab you are not looking at shows its agent's current task there.

Command F opens the find bar in the terminal you are in. It searches the screen and its whole history, highlights every match, and shows the count; Command G and Shift Command G move between matches, and Command E finds the text you selected. Turn on Match Case to match capitals exactly. Find is also in Edit ▸ Find.

The search at the top of the window (Shift Command K, or Command K) finds Code Mode's tabs and agents, your projects, Agent Mode's chats, and every command and prompt. Before you type, it shows what needs you and your recent tabs. For keyboard-only reading and copying, copy mode (Control Space, [) moves through a terminal's history with the keys in Keys.

Sessions that keep running

Each terminal runs in its own small process, apart from the app. Quit Brunvo (Command Q), let it update, or close the window, and your shells and agents keep working; open Brunvo again and every project and tab comes back with its screen and its history. When an update is ready, Relaunch to Update waits at the bottom of the sidebar until you choose it, and your sessions keep running through it.

Command S saves a snapshot of the projects you have open. A restart of your Mac ends running programs: Brunvo brings back their screens and folders, and agents that were working pick up the same conversation.

Git, Files, and Issues

The side panel on the right holds the panels for the project you are in. Each key opens its panel, and the same key again hides it:

  • Git (Option G): what changed, staging by file or by line, commits, branches, and pull requests. Press Shift C on a line of a diff to comment on it, then send every comment to the agent working in that folder as one message, pasted into its input for you to send. Review This Agent's Work, in an agent's menu in the sidebar, opens Git on what that agent changed: the whole branch against its base, or only its last turn.
  • Files (Option F): browse, preview, and edit the project's files, and search their names or contents.
  • Issues (Option Shift A): your GitHub issues beside the agents working on them (GitHub and Work Hub).

Any panel can join the board beside a terminal: drag its tab there.

Managers and helpers

A Manager agent takes a whole job: it plans the work, starts helpers in worktrees of their own, and follows them to the end. To start one in Code Mode, open the side panel's Agent tab (Command ;) and press +. In the sidebar each helper sits under its repository and worktree, with a note naming the Manager it works for. When an agent needs you, Option E takes you to it. Managers and helpers has the rest.

Keys

The keys on this page are Brunvo's layout, the default. Press Command / in Code Mode for a sheet of its keys as you have them set. Keys lists every key, the other layouts, and how to change any of them in Settings ▸ Keyboard.

Whatever the layout, Control A or Control B always reach the program in the pane: agents use them.