Configuration
All state lives in ~/.bohay/ (debug builds: ~/.bohay-dev/), created
owner-only (0700).
| File | Contents |
|---|---|
config.json | theme, language, shell, sidebar width, layout, notifications, keybindings |
session.json | the auto-saved session snapshot (workspaces → tabs → panes) |
orch.json | the orchestration task ledger + leases |
modules.json + modules/ | installed extensions and their state |
worktrees/ | worktrees created by bohay, nested per repo |
bohay.sock / bohay-client.sock | the control + render sockets (owner-only) |
Prefer editing config through Settings (it applies live and writes the file for you); hand-edits are picked up on restart. Old config files load cleanly across versions — unknown fields get defaults.
Environment variables
Section titled “Environment variables”| Variable | Effect |
|---|---|
BOHAY_HOME | relocate the state directory |
BOHAY_SHELL | shell for new panes (overrides config.shell) |
BOHAY_PANE_ID | injected into every pane — the pane’s own id |
BOHAY_SOCKET_PATH | injected into every pane — the control socket |