coalwash plugin
Memory-defragment/cleanup engine for agent memory, TWO lanes: class-B (memory + governance files) gets the semantic wash — a free mechanical Quick pass plus a code-enforced fidelity gate blocking any STRUCTURED-token drop by diff (links, dates, versions, frontmatter; prose fidelity is the paid semantic layer's job), consent-gated Full pass, every cut snapshot-backed (whole-run rollback); class-A (transcripts — the estate) gets byte-identity ULTRA archiving, never semantic-edited. Honest frame: slows how fast memory-overhead grows — it does not eliminate memory cost. Zero-dependency, offline, no API keys.
How to install the coalwash plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add TheColliery/CoalWash
/plugin install coalwash@coalwashWhat's inside coalwash
7 parts read from the plugin's own files.
Commands 2
Run as /coalwash:name- /coalwash:stats
CoalWash stats — current band, certain-fat reading, both break-evens, Memory-BMI (informational), pending-ask state, and the last run's trace for this project
- /coalwash:update
CoalWash self-update — check for a newer version and offer to apply it, or set how updates are handled.
Skills 1
Claude loads it when the task matches- coalwash
Memory washer/defragmenter for agent memory — two lanes: class-B (memory+governance) cleans the FAT, never the MEAT; class-A (transcripts) is byte-identity-only. Fidelity-first: a free mechanical Quick pass + a CODE gate blocking any STRUCTURED-token drop by diff; the paid Full pass is a separate consent; every DELETE/MERGE is plan-sourced + snapshot-backed. Session gauge; Fat hysteresis arms OBESE (auto-Quick, standing config, asks only on return). FULL = the economic cut-point (break-even proven, numbers shown): force-runs Quick; still over → one wizard ask, re-armed on growth. A capacity wall forces FULL (wash-if-fat, else consent, externalize). NO calendar cadence — never loop it. A manual `/coalwash` runs a fat-only, muscle-reorg, or estate pass. localOnly = Quick-only, no sub sees memory content. Honest: slows memory-overhead growth, does NOT eliminate it. Triggers: "/coalwash", "clean memory", "defrag memory", a [CoalWash] band nudge. Cross-agent (Claude Code validated). Zero-dep, offline, no API keys.
Hooks 4
Runs on these events- PostToolUsecommand
Agent|Task|Workflow, Edit|Write|MultiEdit
- PreToolUsecommand
Edit|Write|MultiEdit
- SessionStartcommand
No description in the file.
- Stopcommand
No description in the file.
Using coalwash in Claude Code
Type a command in a Claude Code session:
/coalwash:stats
/coalwash:updateSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update coalwash@coalwash
- Refresh the marketplace
- /plugin marketplace update coalwash
- Turn it off for now
- /plugin disable coalwash@coalwash
- Remove it
- /plugin uninstall coalwash@coalwash
Skills in coalwash
- coalwashTheColliery/CoalWash
Memory washer/defragmenter for agent memory — two lanes: class-B (memory+governance) cleans the FAT, never the MEAT; class-A (transcripts) is byte-identity-only. Fidelity-first: a free mechanical Quick pass + a CODE gate blocking any STRUCTURED-token drop by diff; the paid Full pass is a separate consent; every DELETE/MERGE is plan-sourced + snapshot-backed. Session gauge; Fat hysteresis arms OBESE (auto-Quick, standing config, asks only on return). FULL = the economic cut-point (break-even proven, numbers shown): force-runs Quick; still over → one wizard ask, re-armed on growth. A capacity wall forces FULL (wash-if-fat, else consent, externalize). NO calendar cadence — never loop it. A manual `/coalwash` runs a fat-only, muscle-reorg, or estate pass. localOnly = Quick-only, no sub sees memory content. Honest: slows memory-overhead growth, does NOT eliminate it. Triggers: "/coalwash", "clean memory", "defrag memory", a [CoalWash] band nudge. Cross-agent (Claude Code validated). Zero-dep, offline, no API keys.
3 files14stars
coalwash plugin questions
How do I install the coalwash plugin?
In Claude Code run /plugin marketplace add TheColliery/CoalWash, then /plugin install coalwash@coalwash.
What does the coalwash plugin include?
coalwash bundles 2 commands, 1 skill, hooks.
What commands does the coalwash plugin add?
It adds /coalwash:stats, /coalwash:update. Run them in Claude Code with the plugin prefix, for example /coalwash:stats.
How do I update or remove the coalwash plugin?
Update it with claude plugin update coalwash@coalwash in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall coalwash@coalwash.
What license is the coalwash plugin under?
Apache-2.0, as stated in the plugin's manifest.