Your first week, step by step.

Start a project, switch modes, preview, commit, use two accounts, and answer an agent.

On this page

Start a project and its first chat

A project keeps one piece of work together: its goal, its folder, and its chats.

  1. In Agent Mode (⌥A), choose New Project… in the sidebar.
  2. Name it and say in a line what it is for. Brunvo makes it a folder of its own; to work in a folder or repository you already have, choose Open a folder instead (the + by the sidebar’s search, or ⇧⌘O).
  3. The project's page opens with its goal and folder. Type your request in New chat in your project.
  4. Under the box, the AI tool menu picks the tool (Claude Code, Codex, OpenCode, or Grok) and the kind of agent. Send.
The Northwind Bakery project: its goal, the bakery's website, its folder, a new chat box with Claude Code chosen, and its chats.

The chat appears under the project in the sidebar, and its agent starts in its own terminal, already in the project's folder and knowing its goal.

Move between Agent Mode and Code Mode

Both modes show the same sessions. ⌥A (or ⌘1) is Agent Mode, ⌥C (or ⌘2) is Code Mode.

  1. Right-click a chat in Agent Mode's sidebar and choose Open in Code (or Show in Code, for an agent that has no tab there yet): its agent is a tab in Code Mode, under its repository and worktree.
  2. In Code Mode, split it beside a dev server or a shell, and type into any of them.
  3. Press ⌥A to go back: the chat is where you left it.

Preview the work in the Browser

  1. Click the Side Panel button at the top right and choose Browser.
  2. Open your dev server's address, or let the agent open it: since 0.2.7 an agent can open, read, and use its own pages with brunvo browser (the command line).
  3. Use the device buttons beside the address to see the page at phone or tablet size.
  4. To keep the preview open while you work, drag the Browser tab onto the board: it becomes a pane of its own.

Review and commit an agent's changes

  1. Open the Side Panel and choose Git. Changes lists every file the agent changed.
  2. Click a file to read its changes. Check the file, a hunk, or just the lines you want, to stage them.
  3. Write a summary (and a description, if you like) and press Commit: the button says how many files go to which branch.
  4. Publish sends a new branch to its remote; afterwards, Sync keeps it up to date.

Use a Work and a Personal account

  1. Open Settings ▸ AI Tools (⌘,) and find Accounts, under the tools.
  2. Choose Add Account… under Claude Code or Codex, and name it, such as Work.
  3. Choose Sign In…: the tool's own login opens in a tab. Brunvo never sees the password or keys.
  4. Make Default chooses the account new chats and tabs use. For one chat, pick another account from Agent Mode's AI tool menu; for one tab, from the New Tab menu.

Conversations and skills are shared across accounts, and a resumed conversation keeps its account.

Answer an agent that needs you

  1. When an agent asks something (a permission, a question), the bell at the top of the window counts it.
  2. Click the bell: the Notification Center has a card for each notice, with the agent that is waiting at the top.
  3. Click the card: Brunvo takes you to the question, in the agent's own terminal. Answer it there, and the agent goes on.

Each of these is shown in the real app on Features. Something here does not match what you see? Send us a message from Brunvo: Get Help, in the profile menu.