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