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 a desktop ping the moment one 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, with silent desktop notifications.
• Zero-config resume — reopens each agent's own session after a restart, discovered automatically.
• 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, 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