Shifty-Eye-Games/claude-mods/tree/main/plugins/kb-health
kb-health
kb-health は Shifty-Eye-Games/claude-mods の非公開マーケットプレイスにある Claude Code プラグインです。function hook で KB スナップショットの健全性結果と、kb-serve がディスク上のコードを実行しているかをステータス行に表示します。KB スナップショット処理を実行していないマシンでは静かです。
この mod について
kb-health は Shifty-Eye-Games/claude-mods の非公開マーケットプレイスにある Claude Code プラグインです。function hook を使い、各セッションのステータス行に kb-intelligence スナップショットの判定結果と、kb-serve がディスク上のコードを実行しているかを表示します。KB スナップショット処理を実行していないマシンでは何も表示しません。
インストール:
claude plugin marketplace add Shifty-Eye-Games/claude-mods
claude plugin install kb-health@claude-mods
次に、/plugin の Marketplaces で auto-update を有効にするか、~/.claude/settings.json の extraKnownMarketplaces にある autoUpdate を設定します。マーケットプレイスは非公開なので、各マシンであらかじめ非対話式の GitHub アクセス(SSH key または gh auth setup-git)を設定しておく必要があります。以前ローカルフォルダーから読み込んでいた場合は、二重読み込みを避けるため CLAUDE_CODE_PLUGIN_DIRS から削除してください。
インストール
まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。
claude plugin marketplace add Shifty-Eye-Games/claude-mods claude plugin install kb-health
原文 / 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.
