luvus-module

# Writing a luvus module A **luvus module** is a plugin for luvus, mission control for your AI coding agents. There is **no SDK and no scripting engine**: a module is a directory with a `luvus-module.toml` manifest that declares **argv commands** (any executable: `sh`, `python`, `node`, a compiled binary). luvus runs those commands as subprocesses with `LUVUS_*` context in the environment, and the command calls luvus back through the same UHP the `luvus` 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: `luvus-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_luvus_version = "0.8.3" # oldest luvus 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. luvus renders it; you fill it with `ui.dock.push` (see below). - **`[[bars]]`** `id`, `title`, `region` (`top-right` | `bottom-right`), optional `priority` — reserv...