All shelves / Mods / Workflow
so-hud
By Kanevry
so-hud is a Claude Code workflow mod by Kanevry.
Draws Session Orchestrator status and a warning band, and writes a beacon other sessions can read.
Draws
Install
The marketplace name is kanevry.
/plugin marketplace add Kanevry/session-orchestrator /plugin install so-hud@kanevry
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.0
- License
- MIT
- Repo stars
- 53
- Last change
- 2026-10-11
What it can reach
- Draws in the session
- Sees tool calls
- Calls another program on this machine
Claude Code with mod support, tested with 2.1.296. Claude Code only. Needs Node.js 24 or later, and Session Orchestrator from the release that ships this mod or later. The status texts are German. State comes from scripts/so-hud.mjs, called as --json --repo-root every 15 seconds. hooks/beacon-io.mjs is called through the process API to write the beacon file. The author says the mod never changes a tool decision, and that it writes only its own beacon file and its install-path cache. A checkout starts with claude --plugin-dir ./mods/so-hud. The README does not say anything leaves the machine.
The warning band also shows the context percent once it is at 80 percent or more, and a cold-cache line after an hour with a large context. The README does not say that.
Demo

What it hooks into
engine.createWhen Claude Code startssession.startWhen a session startsturn.startWhen Claude starts a turnturn.completeWhen a turn endstool.callAround a tool call, where it can hold onetool.checkA Claude Code eventsession.endWhen a session endsui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- Kanevry
- Category
- Workflow
- Marketplace
- kanevry
- Folder
- mods/so-hud
- Version
- 0.1.0
- License
- MIT
- Repo stars
- 53
- Last change
- 2026-10-11
- Language
- JavaScript
- Files
- 9