Skip to content

Repository files navigation

bohay

bohay logo

Next-Gen mission control for your AI agents.

crates.io ci docs license platforms

Website · Documentation · Releases


bohay — split panes, a live agent sidebar, and a built-in git dashboard in one terminal

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 every agent at once. One sidebar shows what each agent is doing — blocked · working · done · idle — across every project, and Ctrl+Space . jumps straight to whichever one is waiting on you. Working needs on-screen proof, so a launching CLI or your own typing never reads as busy.
  • Never lose a session. Close the terminal and nothing stops. Run bohay again and every pane, tab, and layout is back, with each agent's own conversation resumed automatically — no flags to remember. Fork a session into a new pane to try a second approach without giving up the first.
  • Read the files your agents touch. A file tree tinted by git status, and a fast built-in viewer that marks what changed against your last commit. Open anything in vim, nano, or your $EDITOR without leaving the terminal.
  • Run a team of agents safely. A task board gives each worker its own git worktree and leases on the files it will touch, then merges finished branches through a quality gate.
  • Git without leaving the terminal. Commits, branches, PRs, and issues in a built-in dashboard, with worktrees as first-class workspaces.
  • Work from anywhere. Attach to a session over plain SSH — only the cells that changed cross the wire — and the layout adapts down to a phone screen.
  • Scriptable and extensible. Every action in the UI is also a CLI command over a local socket, and modules in any language plug in through a small TOML manifest.
  • Make it yours. 15 themes, fully remappable keys, movable sidebar docks, and a UI in 8 languages.

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

Install

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

brew install RizRiyz/bohay/bohay      # Homebrew (also a prebuilt binary)
cargo install bohay                   # build from source (needs Rust 1.88+)
# 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

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.

Supported agents

Agent Live status Session resume Precise events (hook)
Claude Code
GitHub Copilot CLI
Codex
opencode
Kimi
Grok
Pi
Cursor resume command
Gemini · Aider · Amp · Droid · Qwen · Kiro

Live status works out of the box for every agent, with no setup.

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

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

GNU AGPL v3 (AGPL-3.0-or-later).

bohay is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License. If you run a modified bohay as a network service, the AGPL requires you to offer its source to that service's users. See the LICENSE for the full terms.