On this page
Connect GitHub
Brunvo reaches GitHub only through your own GitHub command line, gh. It never asks for, reads, or stores a GitHub token.
- Install the GitHub CLI if you don't have it, then sign in once in a terminal:
gh auth login. - Open Settings ▸ GitHub (⌘,). Each connection shows a health dot and the account it is signed in as.
- If one needs something, such as a sign-in or an extra permission for a board, Check shows the command that fixes it, with Copy. You run it yourself.
Everything on this page is optional: Brunvo works the same without GitHub.
See your issues beside the work
Open the Side Panel at the top right and choose Issues. It lists your repositories' issues, each with its number, up to two labels, who it is assigned to, and its agents as they are right now: working, waiting for you, or done.
- Right-click an issue to start an agent on it, or to start one with the context of one of its sessions.
- Search finds issues by their words, and by agent names and states, such as working. Press Return to add GitHub's own matches.
- Agent tabs lead with the issue they work on, such as
78 Fix login, and readCLSD 78once it is closed. Turn that off in Settings ▸ Projects & Tabs ▸ Show issue numbers on tabs.
Link an agent to an issue
A link says which agent worked on which issue, and it is what measured hours come from.
- From a session's menu in Code Mode's sidebar (its ⋯ button, a right-click, or the period key), choose Link an issue.
- Or ask the agent to link itself: agents link the issues they work on with
brunvo issue link, from any folder, and--verifyreads the link back. - An agent that links an issue before naming itself is named after the issue.
Linking an agent to a new issue ends its time on the last one. A link is never needed for the agent to work.
The Work Hub
The Work Hub is a board of every open issue in your repositories, with the agents on each card. It is off until you turn it on in Settings ▸ General ▸ Features, and it reads your GitHub through the GitHub CLI.
- Press ⌥W, or open it from the Side Panel. It is laid out for the narrow column: pick a lane from the strip at the top.
- Drop a card on a lane to move it. To see every lane side by side, drag the Work Hub tab onto your tabs.
- New Work hands a request to a Manager agent: it opens the issue, picks a checkout, and starts an agent on it.
The filter at the top shows All, Needs You, Working, Background, Idle, or Done.
Hours, measured from the work
Brunvo measures the time agents spend on each issue from the links above and each AI tool's own activity, for Claude Code, Codex, OpenCode, and Grok. Nothing is estimated: time with no evidence reads as unmeasured, never as zero.
brunvo hours measure northwind/bakery-site --issue 78
brunvo hours settings set --allocation split
The first prints each day's working time for the issue and its total. By default an issue's hours are the time each of its agents worked on it, added up, so a Manager and its helpers add up; the second splits each minute among the agents working at once instead.
brunvo hours report groups hours by issue, repository, label, or day, as a table, CSV, or JSON. The View ▸ Hours Report window appears once Hours is on: brunvo config set features.hours true.
See Work Hub and issues on Features. Every brunvo command is in the command line reference.