claude-code-mods

Site rules for Claude Code

Two mods that run inside the Claude Code terminal, and the template they were built from. One posts today's context-window conditions. The other makes destructive commands show their dry run and wait for your sign-off.

Today's conditions · token-weather

18%
Clear
36k / 200k
… assistant finished a turn
>
18%

Illustrative recreation. Drag to forecast; in Claude Code the band updates after every turn.

Blast area · permit required

Command
Hazard
Dry run

Illustrative dry-run output. The real mod runs these read-only checks on your machine before asking.

Install · type these in Claude Code

/plugin marketplace add cskwork/claude-code-mods
/plugin install token-weather@claude-code-mods
/plugin install blast-radius@claude-code-mods

Then run /reload-plugins. Needs Claude Code 2.1.287 or later; the mods API is early access.

token-weather

A one-line forecast of your context window, drawn above the prompt. You see how full it is, how fast it is filling, and when compaction is coming, without opening /context.

Forecast bands

IconConditionContext used
☀Clear< 25%
☁Cloudy25–49%
☂Showers50–74%
☇Storm75–89%
↯Compact soon≥ 90%

What the band shows

  • Weather icon and word for how full the window is
  • Percentage used, and tokens used out of the window, like 134.4k / 200k
  • A sparkline of the last 12 turns
  • What the last turn added, like ▲ +98.3k last turn
  • Main-loop turns only; subagent turns are skipped. History lives in $.state, so it survives a hot reload.

blast-radius

Before a risky Bash command runs, it dry-runs what the command would touch and asks you to Proceed or Cancel. Cancel, or closing the dialog, denies the call and tells the model why.

What it stops to check

CommandDry run shown
rm -r, rm -rfSize (du -sh) and file count; flags / ~ . * as very wide
git reset --hardUncommitted files and diff stat
git clean -fgit clean -n: the files it would delete
git push --forceRemote commits that would be lost
git checkout -- ., git restoreWorking-tree diff stat
git branch -D, git stash drop|clearUnpushed commits, stash list
kubectl deletekubectl --dry-run=client: resources it would delete
SQL DROP / TRUNCATE, migrationsFlagged; no dry run possible

Know its limits

  • It reads the command text; it is a guard rail, not a sandbox.
  • Follows cd dir && … and git -C, so checks run where the command would.
  • Globs are not expanded and quoted paths with spaces are split, so the dry run can undercount.
  • With no one to ask (headless runs), risky commands are denied.
  • Each check has a 5-second limit; a failed check says so instead of hiding.

Contractors on site: community mods

The most-starred mods the community has built, checked to be real function-hook mods. Third-party code runs on your machine: read the repo before you install.

Contractor register · GitHub stars, 2 Oct 2026

ModWhat it doesStarsInstall
fast-jev-compactiontamaratran/fast-jev-compaction Replaces the compaction summary: a small model drops stale tool calls, the rest stays word for word.Needs a TypeSafe key; sends the conversation to api.typesafe.ai. 7,314
/plugin marketplace add tamaratran/fast-jev-compaction
/plugin install fast-jev-compaction@fast-jev-compaction
compact-adviserkunchenguid/compact-adviser Tells you when finished work makes /compact worthwhile. 192
/plugin marketplace add kunchenguid/compact-adviser
/plugin install compact-adviser@compact-adviser
multi-coregreenpolo/cc-multi-cli-plugin Use Codex, Cursor, OpenCode Zen and Antigravity models inside Claude Code. 184
/plugin marketplace add greenpolo/cc-multi-cli-plugin
/plugin install multi-core@cc-multi-cli-plugin
shuntpleaseai/shunt /shunt:usage shows the headroom left on a shared account pool behind a gateway.Reported failing validation on 2.1.274. 167
/plugin marketplace add pleaseai/shunt
/plugin install shunt@shunt
jev-prunertamaratran/jev-pruner Trims long Bash output with a small model before Claude reads it.Needs a TypeSafe key. 156
/plugin marketplace add tamaratran/jev-pruner
/plugin install fast-jev-output@fast-jev-output
winnowGhalebDweikat/winnow A small model judges every tool result before it enters context.Runs a Python helper process. 100
/plugin marketplace add GhalebDweikat/winnow
/plugin install winnow@winnow
Mindful-Claudehalluton/Mindful-Claude Guided breathing above the prompt while Claude works; /breathe picks the exercise. 82
/plugin marketplace add halluton/Mindful-Claude
/plugin install mindful-claude@mindful-claude
jev-rulesEliaAlberti/jev-rules Picks which of your rules apply to each prompt and shows them in a pane. 62
/plugin marketplace add EliaAlberti/jev-rules
/plugin install jev-rules@jev-rules
tw-stock-moddarrell-tw/darrelltw-mods Taiwan and US stock ticker above the prompt. 57
/plugin marketplace add darrell-tw/darrelltw-mods
/plugin install tw-stock-mod@darrelltw-mods
cc-arcadesezaakgun/cc-arcade Tetris and other games above the prompt while you wait. 36
/plugin marketplace add sezaakgun/cc-arcade
/plugin install cc-arcade@cc-arcade

Not in Anthropic's review: these are listed, not endorsed. More in awesome-claude-code-mods. cache-tax (39 stars) has no marketplace file yet.

Method statement: build your own mod

Mods are plugins of function hooks: they observe, rewrite or answer what Claude Code does, and draw their own UI. The template gives you a slash command, a status line, a band and a tested state contract.

Four steps, in order

  1. Clone and scaffold

    Copies the template, renames it, lists it in the marketplace, then validates and tests it.

    git clone https://github.com/cskwork/claude-code-mods
    cd claude-code-mods
    scripts/new-mod.sh focus-timer "Pomodoro in the status line"
  2. Run it live

    Every save hot-reloads the mod in that session.

    claude --plugin-dir "$PWD/focus-timer"
  3. Write the hooks

    Every hook is ($, e, next): call next(e) to pass on, next({ ...e, x }) to rewrite, return without it to answer.

    focus-timer/
    ├── .claude-plugin/plugin.json
    ├── hooks/hooks.json
    ├── hooks/register.tsx
    ├── types/index.d.ts
    └── tests/focus-timer.test.ts
  4. Check and ship

    Validate, test, push. Anyone can then install it from your marketplace.

    claude plugin validate focus-timer
    claude plugin test focus-timer
    git push

Site open. Sign in at the gate.

Three commands, then /reload-plugins. Both mods are small, read-only until you say otherwise, and live in one public repo.

Install · type these in Claude Code

/plugin marketplace add cskwork/claude-code-mods
/plugin install token-weather@claude-code-mods
/plugin install blast-radius@claude-code-mods