main and the agents
you talk to main. main starts one agent per task, the agents work in parallel, and what needs you waits in your inbox.
how it works
- you tell main what you want, in your own words. main is your team lead.
- main turns it into tasks and starts one agent per task. each agent has a brief: the goal, the context, what not to do, and when it's done.
- the agents work in parallel. they message each other and main when their work touches.
- when an agent needs a decision only you can make, it lands in your inbox. the rest never interrupts you.
- when a task is done, its agent lands the work in your repo (see landing work) and reports to main.
you keep typing the whole time. the composer is never locked: ⏎ while main works steers its turn, and tab queues your message for after it.
where main lives
bise desktop
bise desktop shows every project in one window. each project has its own main, and bise, at the top of the sidebar, sits above them: it sees all your projects and passes the work to the right main. see the desktop window.
bise terminal
bise terminal runs in one repo: bise in a folder opens that folder's main and its agents. another repo, another terminal window.
the screen
bise desktop
- the sidebar on the left: bise, the inbox, and your projects, each with its mark:
∿at work,?it asks you,·quiet. - the thread in the middle: the agent you're looking at, main by default.
- the right bar: the project's agents and their state, the archived ones, the artifacts and the timers. the cube on top shows the bims in their office.
bise terminal
- the feed: the thread of the agent you're looking at, main by default.
- the panel on the right: every agent, a number, and its state.
∿working,?needs you,✓done,○idle. - the divider above the composer: who you talk to, its model, its effort and the approvals mode, for example
you → main · opus 5.5 · high · yolo. - the inbox, above the divider when something waits: approvals first, then questions, then merges.
talk to an agent
bise desktop
- click an agent in the right bar, or a bim in the office.
⌥1…⌥9opens the project's agent with that number;⌥0its main.⌘1…⌘9opens a project,⌘0bise.⌘Kfinds an agent, a page or an artifact by name.⌥↑/⌥↓, with the composer empty: the previous / next agent.@agent …in the composer sends that agent a message without leaving the thread you're in.
bise terminal
⌥+ a number goes to that agent;⌥0back to main.escalso goes back to main.- click an agent in the panel.
@agent …from main's view sends it a message without leaving main.@main …from inside an agent.ctrl+s(orcmd+k, or/switch) finds an agent by name, archived ones too.
in an agent's thread, what you type goes to that agent. main still sees it.
the inbox
an inbox item is a question, an approval or a merge that waits for you.
bise desktop
⌘I opens the inbox over the screen you're on: what your agents ask you, from every project, the most blocking first. when bise isn't in front, a macOS notification tells you; the menu bar's :* shows the count.
with an item open:
1…9picks an option, or←→walks them, then⏎.- type an answer and
⏎. ↑↓move to the previous or next item.⌘⌫closes it without answering.escgoes back.
your answer stays next to the thread it came from: an answered item shows what you said and where.
bise terminal
ctrl+1 to ctrl+9 opens the item with that number, or click it, or /inbox.
with an item open:
1-9picks an option, or↑↓then⏎.- type an answer and
⏎(on an approval, typing means no, with your text as the note). ←→moves to the other items.ctrl+xcloses it without answering.escgoes back to your thread; the item keeps your draft.
/answer N text and /close N [note] do the same from the composer.
start, stop and archive
bise desktop
- ask main: it starts the agents.
/newin the composer starts one yourself. ⌘.stops the turn of the agent in view;ctrl+cin the composer too./agents(or the project's⋯menu) opens the project's agents: stop one, or archive it./archivedlists the archived ones, each with restore./in the composer lists the commands; most of bise terminal's work here too, and a command that has a screen in the window (/models,/plugins,/artifacts) opens it.
bise terminal
| command | what it does |
|---|---|
/new [-w] [name:] objective | start an agent yourself; -w gives it its own git worktree |
/agents | list the agents and what they do |
/switch | find an agent by name, archived ones too |
/interrupt | stop the current turn of the agent in view |
/stop <agent> | stop an agent's turn, and its hands on Chrome or an app, until you write to it |
/archive <agent> | stop an agent and archive it, with its worktree |
/restore <agent> | bring an archived agent back |
/archived | show or hide the archived agents in the panel |
/isolate <agent> | give an agent its own git worktree |
/rename <agent> <new-name> | rename an agent |
/compact | compact the conversation of the agent in view |
/pause | pause the whole project: every turn stops, messages and timers wait |
/quit | quit; the agents keep running |
every command and key is in keys and commands.
the agents keep running
bise desktop
quitting bise desktop (⌘Q, or quit bise in the menu bar) closes the window, not the work: the agents go on in the background, and open bise to come back.
bise terminal
quitting bise terminal (/quit, or ctrl+c at idle) closes the window, not the work: the agents go on in the background. run bise in the same folder to come back. to stop everything in a folder:
bise switchboard --stop # stop this folder's bise and its agents
bise switchboard --stop --keep-agents # stop bise, the agents go onpast work
every agent's thread is kept, archived ones too. ask main about past work in your own words ("what did we do on the login last week?"): it searches every thread, from before any compaction too.
worktrees
agents that touch the same files share your folder. main gives a bigger or riskier task its own git worktree, a separate checkout on its own branch, so it never steps on the others. in bise terminal, ψ in the panel marks an agent alone in its worktree. the worktree is removed when its work has landed and its last agent leaves.