house-rules

by David Coulson · ★ 0 · updated 12 Oct 2026

ToastsGuardsCommandsvalidates

0

Your homelab conventions as rules on Claude's tool calls: a note, an ask or a refusal when a call breaks one (Unraid appdata paths, CLAUDE.local.md staged, force-push to upstream, HA restarts). /rules lists them with hit counts; /rules add makes your own.

install house-rules

Install

/plugin marketplace add davidcoulson/crab-workshop
/plugin install house-rules@crab-workshop

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events
session.starttool.checktool.callcommand.run
API calls
$.command.register$.state.get$.state.set$.store.get$.store.set$.ui.toast
Can see
every tool call
Reach
level 1 of 3 reads mod statepersists statedraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/davidcoulson/crab-workshop
Path in repo
plugins/house-rules
Source commit
d964ccc the exact code the scan read
Author
David Coulson @davidcoulson
License
MIT
First published
Last pushed
First listed here

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.

More from davidcoulson/crab-workshop

codex-corner

davidcoulson/crab-workshop

A boxing ring for Codex adversarial reviews: each review is a round, your crab against the Codex bot, with findings by severity, until the verdict is approve and the bot goes down. Rounds are kept per repo and branch; /codex-card prints the bout.

★ 0BandsGuardsCommands

fuel-gauge

davidcoulson/crab-workshop

Context and plan-limit meter: context fill, the 5-hour and weekly windows and session cost in the status line, a toast as a window crosses your thresholds, and /fuel for a pane with every running side session's context.

★ 0PanesBandsStatus line

gatekeeper

davidcoulson/crab-workshop

Your open PRs and what each waits on (/gates): the template boxes only you can tick, CodeRabbit threads and change requests, Codecov, CI, conflicts and drafts ready for you, sorted so what needs you comes first. A band above the prompt counts them; Claude can ask through the gates tool.

★ 0PanesBandsStatus line

gpu-crab

davidcoulson/crab-workshop

While a local-llm tool runs on your Ollama box, a crab on a treadmill shows the loaded model, VRAM, GPU/CPU split and elapsed time above the prompt (amber when a model spills to CPU), and /gpu keeps a 'kept on the LAN' tally of what local models read instead of the cloud.

★ 0BandsGuardsCommands

keymaster

davidcoulson/crab-workshop

Secret tripwire: masks API keys, tokens, passwords and private keys in tool output before Claude, the transcript or your screen sees them, says so in a toast, and counts saves in the status line. /keymaster lists what was masked (kind and place, never the value).

★ 0Status lineGuardsCommands

reef

davidcoulson/crab-workshop

Your homelab as an aquarium (/reef): every Docker container is a fish coloured by its stack, unhealthy ones float belly-up, the Ollama GPU is a heater that glows while a model is loaded, Home Assistant is a lighthouse that blinks red with repairs, and a crab walks the sand for each side session at work.

★ 0PanesCommands

roll-call

davidcoulson/crab-workshop

A status roll-up of your side sessions (/rollcall): each crab holds a sign saying where its session stands, with a 'needs you' lane for sessions waiting on your answer, your OK or your checkbox.

★ 0PanesStatus lineGuards

trailer-guard

davidcoulson/crab-workshop

Per-repo commit attribution policy: refuses a git commit, gh pr create/edit or git push that would carry a Co-Authored-By: Claude trailer or the Generated with Claude Code footer into a repo that forbids them (tinkerologie, esphome, home-assistant upstreams by default), with the lines to remove.

★ 0GuardsCommandsPrompt

vitals-strip

davidcoulson/crab-workshop

Unraid and Home Assistant health above the prompt: array and ZFS pools, CPU and memory, the Docker service, the Unraid integration's problem sensors (shelves, HBAs, optics), unread Unraid alerts, parity runs, and HA state, repairs and notifications. Unraid is read through the Unraid Management Agent integration in HA, in one read-only template call. Quiet by default: it shows only what isn't...

★ 0BandsStatus lineCommands

where-am-i

davidcoulson/crab-workshop

Shows which machine and repo a session runs in (Mac or the claude-code container, repo, branch, fork) in the status line, and nudges Claude when it reaches for the container from the Mac or runs a repo's tests on the wrong host.

★ 0Status lineGuardsCommands