Quickstart

bohay is a terminal workspace for AI coding agents: split panes, a live sidebar of every agent’s state, sessions that survive closing the terminal, and tools to run many agents on one project without conflicts.

Install

macOS / Linux

curl -fsSL https://bohay.dev/install.sh | sh

Prebuilt binaries for Apple silicon and Linux (x86_64 / arm64).

Homebrew

brew install RizRiyz/bohay/bohay

Cargo

cargo install bohay

Any platform with Rust ≥ 1.82 — including Intel macs.

Windows

irm https://bohay.dev/install.ps1 | iex

Use bohay inside Windows Terminal.

Run it

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

That’s genuinely it. bohay starts a background server that owns your panes and attaches a lightweight client — close the terminal any time and everything keeps running. Start your agents in panes like you normally would; bohay recognizes them automatically and shows their live state in the sidebar.

macOS: free the prefix key

macOS reserves Ctrl+Space for input-source switching, which blocks bohay’s prefix. Untick Select the previous input source under System Settings → Keyboard → Keyboard Shortcuts… → Input Sources. Everything is also fully mouse-driven, so nothing else is blocked in the meantime.

Next steps

Your first session

A five-minute tour: split panes, run an agent, detach, come back. Take the tour →

Work with agents

Live states, notifications, zero-config session resume, integrations. Agent guide →

Run agents in parallel

The orchestration board: isolated worktrees, path leases, merge gates. Orchestration →

Script everything

Every UI action is a CLI command over a local socket. Scripting →