FAQ & Troubleshooting
Ctrl+Space does nothing (macOS)
Section titled “Ctrl+Space does nothing (macOS)”macOS grabs Ctrl+Space for input-source switching. Untick Select the
previous input source in System Settings → Keyboard → Keyboard Shortcuts…
→ Input Sources. Meanwhile: everything is mouse-driven, and Shift+↑
scroll mode needs no prefix.
I upgraded but see no changes
Section titled “I upgraded but see no changes”The background server is still the old version — it keeps running across
installs by design. Run bohay server restart (your session is saved and
restored). bohay also warns about this at attach.
The git tab is empty / PRs are missing
Section titled “The git tab is empty / PRs are missing”Run bohay doctor. Local views need git; PRs/issues need an authenticated
gh (gh auth login). Without gh the tab is a local-git viewer.
An agent shows as plain zsh / isn’t detected
Section titled “An agent shows as plain zsh / isn’t detected”Detection recognizes agents from an allowlist (Claude Code, Copilot, Codex, opencode, Cursor, Gemini, Aider, Amp, Droid). If yours is missing, open an issue — additions are small.
Where did my scrollback go?
Section titled “Where did my scrollback go?”Each pane keeps 5 000 lines of history. Full-screen apps (vim, TUI agents) own their own scrolling — bohay forwards the wheel to them; use the app’s native scrolling there.
Windows: what’s different?
Section titled “Windows: what’s different?”Use Windows Terminal. Live per-pane cwd tracking and the shell hook aren’t available; zero-config agent resume still works. Named pipes replace Unix sockets transparently.
The terminal shows ”◱ enlarge terminal”
Section titled “The terminal shows ”◱ enlarge terminal””The window is too small to render the UI (under ~24×6 cells) — make it bigger.
How do I completely reset?
Section titled “How do I completely reset?”bohay server stoprm -rf ~/.bohay # session, config, orch ledger, modules — everything