bohay

Next-Gen mission control for your AI agents.

One place to run, watch, resume, and orchestrate every coding agent.

Website · Documentation · Releases

Why bohay?

Working with AI coding agents means juggling terminal windows — one waits for
permission while you watch another think, and a third finished ten minutes ago
without you noticing. bohay puts them all in one place.

• See everything at once — a sidebar with every agent's live state (blocked ·
  working · done · idle) across all your projects, plus an optional retro chime
  the moment one finishes or needs you.
• Never lose a session — panes survive closing the terminal; reattach and each
  agent's own conversation resumes automatically, no flags to remember.
• Run agents in parallel, safely — a task board gives each worker an isolated
  git worktree and file-path leases, then merges finished branches through a gate.
• Stay on the keyboard — a built-in git dashboard, worktrees, remote sessions
  over SSH, and a full scripting API, all without leaving the terminal.

Ships as a single ~3 MB Rust binary — fast, native, memory measured in
single-digit megabytes.

Install

# macOS (Apple silicon) / Linux — prebuilt binary, no Rust needed
curl -fsSL https://bohay.dev/install.sh | sh

brew install RizRiyz/bohay/bohay      # Homebrew
cargo install bohay                   # any platform, incl. Intel macs

# Windows (PowerShell) — use bohay inside Windows Terminal
irm https://bohay.dev/install.ps1 | iex

Quick start

bohay          # launch — or reattach to — your session
bohay doctor   # check your setup: git, gh, ssh

bohay runs a background server that owns your panes and attaches a thin client,
so you can close the terminal any time and reattach by running bohay again.
Open any folder with Ctrl+Space N (or run bohay inside it), split panes, and
start your agents — bohay recognizes them automatically.

macOS: free the Ctrl+Space prefix under System Settings → Keyboard →
Keyboard Shortcuts → Input Sources (untick Select the previous input source).
Everything is mouse-driven too, so you're never locked out. More →

Supported agents

Live status works out of the box for every agent. Session resume & hooks →

What's inside

• Live agent sidebar — every agent's state across all projects, a spinner while it works, and an optional retro chime when one finishes or blocks (off by default).
• States you can trust — working needs on-screen proof (a spinner, an interrupt hint), so a launching CLI or your own typing never reads as work. Tune or add agents with plain TOML rules in ~/.bohay/manifests/.
• Zero-config resume — reopens each agent's own session after a restart, discovered automatically. Restored panes open straight into the resuming agent, nothing typed at a prompt.
• A session that can't die by accident — only bohay server stop ends it. Closing the last pane keeps the server alive, and a reboot or kill saves everything on the way out.
• Git dashboard — commits, flow, branches, PRs, issues; merge & approve without leaving the terminal.
• First-class worktrees — a branch per workspace, nested under its repo.
• Multi-agent orchestration — task board, isolated workers, path leases, quality + merge gates.
• Remote over SSH — attach to a session on another machine; only changed cells cross the wire.
• Scriptable to the core — every UI action is a CLI command over a local socket.
• Extensible — modules in any language via a small TOML manifest.
• Make it yours — 10 themes, fully remappable keys, two sidebars of movable docks (modules can add their own), and a UI in 8 languages.

→ Full guides, keybindings, and the complete CLI reference live at
bohay.dev/docs — or run bohay help.

The macOS notch companion

bohay-notch is a native SwiftUI app that lives in your notch and menu bar. Hover
for a live panel of every agent — logo, model, project, running cost, and state.
Approve a blocked agent right there, or click any agent to jump to its pane.

brew install --cask --no-quarantine RizRiyz/bohay/bohay-notch

Requires macOS 15+ (ad-hoc signed, hence --no-quarantine). Details →

Development

cargo build            # pure Rust, no C toolchain
cargo test             # unit + off-screen render tests (no tty needed)
cargo run -- --local   # client + server in one process

A headless server owns the panes and renders frames into an off-screen buffer;
a thin client blits them to your terminal; state is pure, driven by one event
loop. Debug builds use ~/.bohay-dev/, so hacking never touches your real session.

Contributions welcome — see CONTRIBUTING.md. Security reports:
SECURITY.md.

License

MIT