kochetkov-maBrewtools
Universal text utilities plugin for Claude Code -- token optimization, AI artifact removal, secrets scanning, SSH management, GitHub Actions deployment, and plugin updates.
| Field | Value |
|---|---|
| Version | 5.5.0 |
| Skills | 13 |
| Agents | 3 |
| Hooks | 2 |
Install
Paste this into a Claude Code session:
Execute these commands in this session, one by one, show full output for each, do not skip any:
1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewtools@claude-brewcode
After install, run `/reload-plugins` (or `exit` + `claude`).
Or install the whole suite
Execute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:
1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewcode@claude-brewcode
3. claude plugin install brewdoc@claude-brewcode
4. claude plugin install brewtools@claude-brewcode
5. claude plugin install brewui@claude-brewcode
After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.
Update anytime with /brewtools:plugin-update.
Overview
Brewtools provides standalone utilities: token-efficient optimization with 52 validated rules, universal AI-artifact removal with greedy flow detection across code/docs/articles/reddit/chat (five domain flows, two-pass strip+inject model), security scanning for leaked credentials, SSH server management, GitHub Actions deployment with safety gates, and plugin check/install/update. Each skill is self-contained and requires no prior setup.
Installation
# Marketplace (recommended)
claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
claude plugin install brewtools@claude-brewcode
# Already installed? Update
claude plugin marketplace update claude-brewcode
claude plugin update brewtools@claude-brewcode
# Dev mode (no install)
claude --plugin-dir ./brewtools
Quick Start
/brewtools:text-optimize CLAUDE.md # Medium mode (default)
/brewtools:text-optimize -l agents/reviewer.md # Light mode -- safe, minimal changes
/brewtools:text-optimize -d prompts/ # Deep mode -- aggressive compression
/brewtools:text-optimize -s README.md # Standard mode -- 30-50%, human-readable, verified
/brewtools:text-optimize -x CLAUDE.md # Max mode -- 3-4x, opt-in, 2 verification rounds
/brewtools:text-human 3be67487 # mixed flow: clean all files from a commit
/brewtools:text-human src/main/java/services/ # mixed flow: entire folder, parallel blocks
/brewtools:text-human "humanize this blog post: <text>" # article flow: burstiness + stance injection
/brewtools:text-human src/ only strip AI artifacts, no inject # custom prompt overrides defaults
/brewtools:secrets-scan # Scan for leaked credentials
/brewtools:secrets-scan --fix # Scan and fix interactively
/brewtools:plugin-update # Interactive check + update
/brewtools:plugin-update check # Status table only
Setup skills all speak the same verbs:
/brewtools:manager-setup # No verb = status if installed, install if not
/brewtools:manager-setup install # Install the HARD delegation wall into this project
/brewtools:manager-setup disable # Disarm it, keep the files
/brewtools:think-short-setup install global # Terse-mode hooks, global scope
/brewtools:agent-deadline-setup install project 20 # 20-minute subagent budget
/brewtools:agent-return-setup install global 800 2000 # size budget on subagent returns
/brewtools:task-board-setup install ~/repos/api # Kanban into another repo
/brewcode:setup-status # What is installed / stale / missing, everywhere
Skills
Naming rule. A
-setupsuffix marks a skill that installs a mechanism -- after running it you use the installed hooks, guard or generated skill, not the setup skill itself. Recurring tools you invoke every time (text-optimize,secrets-scan,ssh, ...) keep bare names.
Canonical modes. Every
-setupskill answers the same verbs, in this order:status | install | upgrade | enable | disable | uninstall | purge. No argument =statusif installed,installif not. Skill-specific extras (scope, level, minutes, path) come after the canonical verb. The v4 aliasesinit,on,off,setup,removeandresetare gone -- v5.0.0 is a deliberate breaking change with no back-compat. Not every skill implements all seven; the Arguments column below is authoritative per skill.
Run
upgradein every project that already has one of these installed. A-setupskill copies files INTO the project; a plugin update does not reach those copies. Two of them matter right now:
/brewtools:manager-setup upgrade— backfillsmanager-state.mjs(the wall's off-switch CLI) into projects installed before it existed. Without it the documented disarm command has no script to run./brewtools:think-short-setup upgrade— installs thethink-short-task.mjsthat actually detects a foreignTask/Agenthook. Older copies reportinjects=unknowninstatus.
Run
/brewcode:setup-statusto see which setup skills are installed, stale or missing in the current project, with the exact command to run for each.
| Skill | Purpose | Model | Arguments |
|---|---|---|---|
/brewtools:text-optimize |
Optimize text for LLM token efficiency | sonnet | [-l|-s|-d|-x|--max] [file|folder|path1,path2] |
/brewtools:text-human |
Humanizes code, docs, articles, reddit/chat, javadoc -- strips AI artifacts, fixes unicode, fits register | sonnet | [path|commit|folder|text] [custom instructions] |
/brewtools:secrets-scan |
Scan for leaked secrets and credentials | sonnet | [--fix] |
/brewtools:ssh |
SSH server management and configuration | opus | <prompt describing what to do> |
/brewtools:deploy |
GitHub Actions deployment with safety gates | opus | <prompt describing what to do> |
/brewtools:manager-setup |
Manager mode: installs a hard delegation wall into this project and explains/customizes codewords ++m (delegate-everything, plan-aware), ++a (architecture-first), ++rr (anti-regression review), ++r (two-phase double-check). The codewords are hook-driven and fire whether or not the wall is installed; the wall itself is opt-in, per-project, and blocks main-session writes while subagents stay free |
sonnet | [status|install|upgrade|enable|disable|uninstall|purge] [level strict|balanced] [edit] | <task в хард режиме> | <task от роли менеджера> | <prompt> |
/brewtools:plugin-update |
Check/install/update brewcode plugins | sonnet | [check|update|all] |
/brewtools:provider-switch |
Configure alt API providers: DeepSeek, Z.ai/GLM, Qwen, MiniMax, OpenRouter | opus | [status|install|verify|model-check|help|<provider-name>] -- no args = interactive status check |
/brewtools:think-short-setup |
Install/remove terse-mode hooks (SessionStart + every-10th UserPromptSubmit + subagent Task) that inject brevity directives; project or global. disable flips a flag and leaves the files in place; purge deletes files and state |
sonnet | [status|install|upgrade|enable|disable|uninstall|purge] [project|global] | free-text intent |
/brewtools:agent-deadline-setup |
Install/remove a soft wall-clock budget for subagents: 80% -- non-blocking "wrap up" warning, 100% -- deny all tools except the finalization set; project or global, opt-in | sonnet | [status|install|upgrade|enable|disable|uninstall|purge] [project|global] [minutes] | free-text intent |
/brewtools:agent-return-setup |
Install/remove a size budget on every subagent's final return message: a SubagentStart hook injects the contract, a SubagentStop hook sizes the return (chars/4) and blocks at most once -- above passTokens (default 1000) it orders a compress, above fileTokens (default 2500) a write-to-file plus the path. No LLM judge; project or global, opt-in |
sonnet | [status|install|upgrade|enable|disable|uninstall|purge] [project|global] [pass] [file] | free-text intent |
/brewtools:agent-router-setup |
EXPERIMENTAL. Install/remove a PreToolUse hook that denies a generic subagent spawn in favor of the real project/plugin expert, or nudges when the fit is only uncertain; tier 1 free and deterministic, tier 2 opt-in LLM judge not yet behaviorally verified; project scope only | sonnet | [status|install|upgrade|enable|disable|uninstall|purge] [level fast|strict] | free-text intent |
/brewtools:task-board-setup |
Generator: deploys a file-based Kanban into any repo via multi-agent analysis, with an optional spec + design layer (task-spec skill) and an upgrade mode to retrofit it onto an existing board, plus an optional gated CLAUDE.md-optimization pass |
opus | [status|install|upgrade|uninstall|purge] [target repo path | empty = cwd] [free-text directive, e.g. 'also dedupe rules', 'skip module split'] |
Agents
| Agent | Model | Purpose |
|---|---|---|
| text-optimizer | sonnet | Optimizes text/docs for LLM token efficiency |
| ssh-admin | inherit | Linux server admin: SSH, Docker, systemd, Nginx, SSL |
| deploy-admin | inherit | GitHub Actions deployment: workflows, releases, GHCR, CI/CD |
Scope guard: every agent stops and proposes a split when a task exceeds one bounded unit (one deliverable, ~5 files).
ssh-adminsplits per host,deploy-adminper repo and per environment.
Architecture
brewtools/
+-- .claude-plugin/plugin.json # Plugin manifest
+-- hooks/
| +-- hooks.json # Hook registry
| +-- session-start.mjs # Manager HARD-wall awareness
| +-- manager-prompt.mjs # ++m / ++a / ++rr / ++r codeword injection
| +-- hardmode-guard.mjs # HARD-wall guard template (not registered; copied per project by manager-setup)
| +-- lib/utils.mjs # I/O utilities
+-- skills/
| +-- text-optimize/ # Token optimization
| +-- text-human/ # AI artifact removal
| +-- secrets-scan/ # Secrets scanning
| +-- ssh/ # SSH server management
| +-- deploy/ # GitHub Actions deployment
| +-- plugin-update/ # Plugin check / install / update
| +-- provider-switch/ # Alternative API provider management
| +-- think-short-setup/ # Terse-mode hooks install/remove
| +-- agent-deadline-setup/ # Subagent soft wall-clock budget hooks install/remove
| +-- agent-return-setup/ # Size budget on subagent return messages (SubagentStart + SubagentStop)
| +-- agent-router-setup/ # EXPERIMENTAL: route generic subagent spawns to the real expert
| +-- manager-setup/ # Codeword-triggered Manager mode + HARD delegation wall
| +-- task-board-setup/ # File-based Kanban generator (multi-agent)
+-- agents/
+-- text-optimizer.md # Text optimization agent
+-- ssh-admin.md # SSH and server administration
+-- deploy-admin.md # Deployment and CI/CD
Brewtools vs Brewcode: Brewtools provides standalone text utilities with no lifecycle dependencies. Brewcode is a task execution engine with infinite context and session handoff. Both install from the same
claude-brewcodemarketplace but operate independently.
Artifact metadata
Every artifact a -setup skill installs into your project carries the same four fields, so you can
tell at a glance what wrote a file and which plugin version it was written at.
| Field | Values | Where |
|---|---|---|
doc_type |
llm | user | skip -- unquoted |
.md frontmatter only, never JSON |
version |
"X.Y.Z" -- plugin version at install time |
all carriers |
generated_by |
"<plugin>:<skill>" |
all carriers |
last_updated |
"YYYY-MM-DD" |
all carriers except a byte-copied .mjs/.sh/.md |
A byte-copied asset omits last_updated: the value would be the release date,
identical in the plugin file and the copy, so rewriting it on every build would churn bytes and
defeat the cmp drift check that mechanism exists for. The four keys always sit after the file's
own keys, in that order. JSON artifacts carry the same three snake_case keys at top level (no
doc_type) in every writing mode. Five carriers exist: JSON keys, .md frontmatter, a
// brewcode-meta: / # brewcode-meta: one-liner on line 2 of a byte-copied .mjs/.sh, a header
table in team.md, and <!-- brewcode-meta: ... --> on line 1 of a byte-copied .md. Versions
always come from .claude-plugin/plugin.json, never hardcoded.
/brewcode:setup-status reads these back across every setup skill installed here.
Hooks
| Hook | Event | Purpose |
|---|---|---|
session-start.mjs |
SessionStart | Manager HARD-wall awareness -- injects guard tag plus the bounded-unit delegation brief (goal + scope + what is already done + who consumes the result + acceptance) into systemMessage and additionalContext |
manager-prompt.mjs |
UserPromptSubmit | Injects ++m (manager, plan-aware) / ++a (architecture-first) / ++rr / ++r codeword blocks |
Documentation
Full docs: doc-claude.brewcode.app/brewtools/overview
| Resource | Link |
|---|---|
| Text Optimize | text-optimize |
| Text Human | text-human |
| Secrets Scan | secrets-scan |
| SSH | ssh |
| Deploy | deploy |
| Manager Setup | manager-setup |
| Plugin Update | plugin-update |
| Provider Switch | provider-switch |
| Think Short Setup | think-short-setup |
| Agent Deadline Setup | agent-deadline-setup |
| Agent Return Setup | agent-return-setup |
| Agent Router Setup | agent-router-setup |
| Task Board Setup | task-board-setup |
| Setup Status (brewcode) | setup-status |
| Text Optimizer (agent) | text-optimizer |
| SSH Admin (agent) | ssh-admin |
| Deploy Admin (agent) | deploy-admin |
| Release Notes | RELEASE-NOTES.md |
Author: Maksim Kochetkov | License: MIT