Shifty-Eye-Games/claude-mods/tree/main/plugins/kb-health
kb-health
kb-health is a Claude Code plugin in the private Shifty-Eye-Games/claude-mods marketplace. A function hook shows KB snapshot health results in the status line and whether kb-serve is executing code from disk; it stays quiet on machines that do not run KB snapshot work.
About this mod
kb-health is a Claude Code plugin in the private Shifty-Eye-Games/claude-mods marketplace. Through a function hook, it shows the kb-intelligence snapshot verdict in each session's status line and whether kb-serve is executing code from disk; it shows nothing on machines that are not running KB snapshot work.
Installation:
claude plugin marketplace add Shifty-Eye-Games/claude-mods
claude plugin install kb-health@claude-mods
Then enable auto-update in the Marketplaces view under /plugin, or set autoUpdate under extraKnownMarketplaces in ~/.claude/settings.json. Because the marketplace is private, each machine must have non-interactive GitHub access configured in advance (SSH key or gh auth setup-git). If it was previously loaded from a local folder, remove it from CLAUDE_CODE_PLUGIN_DIRS to avoid loading it twice.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add Shifty-Eye-Games/claude-mods claude plugin install kb-health
Original text / README
claude-mods
Private Claude Code marketplace for Tuncer's mods: function-hook plugins that run inside every Claude Code session on his machines (MacBook Pro, MacBook Air, therig, the 5090 PC).
| Plugin | What it does |
| --- | --- |
| memory-guards | Refuses the footgun commands Claude's memory notes warn about (for example impeccable update --help, routing shiftyeyegames.com DNS through cloudflared, /logout before cswap add) and says why, with the safe alternative. |
| kb-health | Shows KB health in the status line on the machine that runs the KB. It stays quiet on machines without the KB snapshot job. |
| machine-tag | Prefixes session titles with the machine's emoji tag (💻 MBP, 🪶 Air, 🎮 Rig, 🔥 5090), so pinned sessions show which computer they run on. /machine-tag <emoji> <word> overrides it per machine. |
Install on a machine
claude plugin marketplace add Shifty-Eye-Games/claude-mods
claude plugin install memory-guards@claude-mods
claude plugin install kb-health@claude-mods
claude plugin install machine-tag@claude-mods
Then turn on auto-update: in /plugin, open Marketplaces, pick claude-mods and enable auto-update, or set it in ~/.claude/settings.json:
"extraKnownMarketplaces": {
"claude-mods": {
"source": { "source": "github", "repo": "Shifty-Eye-Games/claude-mods" },
"autoUpdate": true
}
}
Each session start then pulls main. No versions are set, so every commit is an update.
The repo is private, so each machine needs GitHub access without a prompt: an SSH key GitHub knows (Claude Code tries ssh -T [email protected] first), or stored HTTPS credentials (gh auth login then gh auth setup-git, or Git Credential Manager on Windows). Without them the clone and the updates fail silently and the machine keeps its last copy.
Machines that loaded these mods from local folders before must drop those folders from CLAUDE_CODE_PLUGIN_DIRS in ~/.claude/settings.json, or each mod loads twice.
Change a mod
- Edit it under
plugins/<name>/. - Check it:
claude plugin validate plugins/<name>andclaude plugin test plugins/<name>. - Push to
main. Versions are left unset on purpose, so each commit reaches every machine at its next session start.
How mods work, and the engine rules that bite, are in Claude's memory note on Claude Code mods.
Security
Auto-update is on, so whatever lands on main runs in every session on all four machines. Only org admins can push here (the org's default member permission is read). Keep it that way: never give anyone else write access.
