Bring your work with you.

Your folders, repositories, worktrees, conversations, keys, and settings, from wherever they live now.

On this page

Brunvo works with your files where they are. Nothing needs converting: a repository stays a Git repository, and your AI tools keep their own conversations and sign-ins. Moving in is mostly telling Brunvo where things are.

Folders and repositories

  1. In Code Mode (⌥C), choose Open a folder (⇧⌘O, or the button by the sidebar's search). Search your projects, type a path, or drop a folder from Finder.
  2. Each folder becomes a project in the sidebar: a Git repository under Repositories, any other folder under Folders.
  3. To have Open a folder list everything you keep in one place, such as ~/Developer, add that folder in Settings ▸ Projects & Tabs.

In Agent Mode, the + beside Projects makes a project from a folder you already have, with its goal; the agents you start there work in that folder.

A repository in a folder that syncs, such as iCloud Drive's Desktop & Documents, is better moved somewhere plain. Move Folder… in the sidebar moves it, agents and all: see Move a folder.

Worktrees

Worktrees you already made with Git show under their repository, each by its folder, as soon as the repository is open. Worktrees you or an agent add later with Git in a terminal appear right away too, and ones you remove disappear.

To make a new one, use New Worktree on the repository's row. Brunvo never removes a worktree you made yourself.

Agent conversations

Your AI tools keep their own conversations, so the ones you had before Brunvo are still there.

  1. Open a tab in the conversation's folder (⌥T, or + in the tab row).
  2. Resume it with the tool's own command, for example claude --resume or codex resume, and pick the conversation.

From then on the agent is one of Brunvo's: its tab shows what it is doing, and it keeps running when Brunvo quits; Claude Code and Codex start on the account you chose in Brunvo. Your existing sign-ins work as they are, as System Sign-In in Settings ▸ AI Tools ▸ Accounts.

Programs running in another terminal

A program already running in another terminal app stays there: no app can take over another's running process. Start it again in a Brunvo tab when it is convenient, such as a dev server between changes. From then on it survives Brunvo quitting, crashing, or updating, and comes back with its screen. Brunvo never needs another terminal app installed or running.

Keys and settings

  • Keys: in Settings ▸ Keyboard, choose a layout: Brunvo's Option keys, or the macOS standard layout. Import… there reads a keybindings.json from another Mac, or the keybind lines of a terminal's config file, and shows what changes before anything does. See Keys.
  • Prompts: Settings ▸ Prompts chooses the folder your prompt library lives in. A repository's own .brunvo/prompts shows beside it.
  • Another Mac: File ▸ Export ▸ Export Settings… writes your settings to a file, and File ▸ Import ▸ Import Settings… on the other Mac shows what it changes before it does.

New to Brunvo? Your first 15 minutes walks through one job from start to finish.