lich-plugin

The Claude Code side of the lich integration. lich is a harness that orchestrates claude sessions; this companion plugin gives it eyes and hands inside each session. Every hook implements a contract that is canonical in the lich repository (docs/hooks/ there); the docs in docs/ here point at each contract and describe the client side:

• session state — busy/done on the session card (UserPromptSubmit/Stop)
• session start — persists the Claude session id on the lich session (SessionStart)
• session title — names the card after Claude's auto-generated title (Stop)
• session touched — refreshes the card's git status right after file-mutating tools (PostToolUse)

It also ships skills for the parts of lich you configure from inside a session:

• theme (/lich:theme) — write, port or fix a lich color theme: the app tokens, the xterm palette, where the file goes, and a validator for the rules that otherwise fail silently

Structure

.claude-plugin/plugin.json      # plugin manifest (required)
hooks/hooks.json                # hook registration
hooks/report-state.sh           # session-state hook
hooks/report-session-start.sh   # session-start hook
hooks/report-title.sh           # session-title hook
hooks/report-touched.sh         # session-touched hook
docs/                           # client-side docs, one per contract
skills/theme/                   # theme skill: SKILL.md, template.json, validate.mjs

Hook scripts live in hooks/ and are referenced from hooks.json via ${CLAUDE_PLUGIN_ROOT}/hooks/<script>.

Installation

Add this repository as a marketplace and install the plugin:

claude plugin marketplace add omartelo/lich-plugin
claude plugin install lich@lich-plugin

The same works inside a session with /plugin marketplace add omartelo/lich-plugin followed by /plugin install lich@lich-plugin.

Manual (from a clone)

git clone https://github.com/omartelo/lich-plugin.git

Then either load it for a single session:

claude --plugin-dir ./lich-plugin

or register the clone as a local marketplace for a persistent install:

claude plugin marketplace add ./lich-plugin
claude plugin install lich@lich-plugin

Outside lich (env vars absent) the hooks are a no-op — the plugin is safe to install globally.

Local testing

claude --plugin-dir .