bise docs
bise runs a team of AI agents for you. you talk to one agent, main, and it runs the others. two apps, the same agents.
you talk to main, your team lead. main turns what you ask into tasks and starts one agent per task. the agents work in parallel, talk to each other, and land their work in your repo. what needs you waits in your inbox.
two apps, one bise
| bise desktop | bise terminal | |
|---|---|---|
| what it is | a window on your Mac: every project in one window, an inbox for what needs you, the bims at work | in your terminal, one thread per repo, keys for everything |
| runs on | Macs with Apple silicon, macOS 14 or later | macOS and Linux, over SSH too |
| how you talk | type, or hold fn in any app | type, or ctrl+r |
| get it | download it | one curl line |
both apps run the same agents, with the same threads, models, keys and settings. use one, or both at once on the same repo.
these docs are one set for both. most of it is the same in both apps. where a step differs, the page shows your app's way: pick yours with the desktop / terminal switch at the top of the list of pages. a page that exists in one app only says so under its title.
start here
- get bise: bise desktop or bise terminal.
- give it a model: an API key from a provider, or a plan you already pay for, through a subscription.
- ask main for something. read main and the agents to see what happens next.
what's in these docs
| page | what you find there |
|---|---|
| providers and keys | the providers bise knows, where a key goes |
| models and roles | which model does what: main, agents, small jobs, voice |
| gateways and local models | LiteLLM, a company proxy, Ollama, LM Studio, vLLM |
| main and the agents | how a task runs, the inbox, talking to an agent |
| the desktop window | projects, bise, the bims, the menu bar, notifications |
| approvals | yolo and auto: what runs without asking |
| landing work | how agents commit, features, pull requests |
| voice and fn | dictation, voice mode, and fn from any app |
| computer use | agents that drive Chrome and your Mac apps |
| plugins and MCP | skills, local and remote MCP servers, logins |
| settings and config.toml | every setting in one place |
| troubleshooting | the setup check, bise doctor, the usual fixes |
for agents
every page is also plain Markdown: add .md to its address, for example bise.dev/docs/providers.md. to have a coding agent install and set up bise terminal for you, give it bise.dev/setup.md.
requirements
bise desktop runs on Macs with Apple silicon, macOS 14 or later. bise terminal runs on macOS (Apple silicon and Intel) and on Linux (x86_64 and arm64, glibc 2.34 or newer). you need git; on Linux, OpenSSL 3 too. see start with bise terminal for the Linux details.