bohay-module

# Writing a bohay module A **bohay module** is a plugin for bohay, mission control for your AI coding agents. There is **no SDK and no scripting engine**: a module is a directory with a `bohay-module.toml` manifest that declares **argv commands** (any executable: `sh`, `python`, `node`, a compiled binary). bohay runs those commands as subprocesses with `BOHAY_*` context in the environment, and the command calls bohay back through the same socket API the `bohay` CLI uses. So a module in bash/python/node can do what a built-in feature does. Reference material in this repo (read for depth): `MODULE-GUIDE.md`, `docs/13-modules.md`, and the worked modules in `examples/modules/` (`branch-dock` = a sidebar dock, `agent-ping` = an event hook, `scratch-pane` = a pane). ## The manifest: `bohay-module.toml` Top-level keys (all required unless noted): ```toml id = "yourname.my-module" # unique, reverse-dns style name = "My Module" version = "0.1.0" min_bohay_version = "0.8.3" # oldest bohay this needs description = "One line." # optional platforms = ["macos", "linux"] # optional; omit = all. Also per-item. ``` Then any of these tables, each declaring an argv `command` (a list, run as-is, cwd = the module dir): - **`[[docks]]`** `id`, `title`, `placement` (`sidebar.left` | `sidebar.right`) — reserve a sidebar dock. bohay renders it; you fill it with `ui.dock.push` (see below). - **`[[startup]]`** `command` — run once when the session is up and the socket is listening (a...