bohay-modulelisted
Install: claude install-skill RizRiyz/bohay
# 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