ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add Kanevry/session-orchestrator
/plugin install so-hud@kanevry
Open the repo

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

The so-hud section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • engine.createWhen Claude Code starts
  • session.startWhen a session starts
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold one
  • tool.checkA Claude Code event
  • session.endWhen a session ends
  • ui.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
Repo
Kanevry/session-orchestrator
Folder
mods/so-hud
Version
0.1.0
License
MIT
Repo stars
53
Last change
2026-10-11
Language
JavaScript
Files
9

Other mods in Workflow

inite-braininite-aiDraws what brain recalled above the prompt, and looks each prompt up before the model reads it.corgi-bandAndriiklymiukDraws corgi sessions waiting on you, and what this turn posted or pushed, above the prompt.corgi-guardAndriiklymiukHolds a commandRefuses the Bash shapes corgi runs lose turns to, and hands the model the corgi fix.tch-activitykylesnowschwartzDraws what Claude is doing, and each tool call it has taken, in a box above the prompt.deadhdlcalmskyDraws a session's done, current, and remaining steps as a checklist, in the terminal and on a page.contextsaverAlmogBakuShows a card when a session's process or a tool habit repeats, with its cost and a fix you can send.fleet-bandwrg32786Draws a line above the prompt with the seat, context percent, unread Room messages, pending results, and seats in a hold.fleet-deliverywrg32786Draws a delivery line under the prompt, and sends one Room message or job result into the session when it is idle.pi-agent-for-claudeFazalAAliShows a pi subagent in Claude Code's agent list, streams its tool calls, and can open that agent in a tmux pane.stoadigital-stoic-orgDraws the save status of a session pack, can clear the context when it fills, and flags files whose sources changed.trailheadToRvaLDzHolds a commandDraws the ticket map beside the chat and the step above the prompt, and refuses a bad commit, a secret, or an unvetted install.notice-boardHolyGrailDraws a band of notices for the other sessions in this repo, or for every session on the machine.
All 396 in Workflow