Brewtools

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	3.18.0
Skills	10
Agents	3

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 30+ 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-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

Skills

Skill	Purpose	Model	Arguments
`/brewtools:text-optimize`	Optimize text for LLM token efficiency	sonnet	`[-l\|-d] [file\|folder\|path1,path2]`
`/brewtools:text-human`	Universal context-aware humanizer: strip AI artifacts and fit register across code, docs, articles, reddit/chat, and commits	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	`[connect\|deploy\|configure\|...]`
`/brewtools:deploy`	GitHub Actions deployment with safety gates	opus	`[release\|workflow\|...]`
`/brewtools:manager`	SOFT: codeword `++m` auto-injects a delegate-everything Manager prompt (plan-aware: adds the plan supplement when the session is in plan mode); `++rr`/`++r` auto-inject review discipline (anti-regression / two-phase double-check) (RU+EN). HARD: `on` installs a PreToolUse guard that blocks Write/Edit/NotebookEdit/WebFetch/MCP-write in the main session (subagents stay free); `off` disarms (registration stays, guard no-ops); `uninstall` deregisters; `level strict\|balanced` tunes the wall	sonnet	`[on\|off\|uninstall\|status\|level <strict\|balanced>\|edit\|reset] \| <prompt>`
`/brewtools:plugin-update`	Check/install/update brewcode plugins	sonnet	`[check\|update\|all]`
`/brewtools:provider-switch`	Configure alternative API providers (DeepSeek V4 [priority], Z.ai/GLM, Qwen, MiniMax, OpenRouter)	opus	`[status\|setup\|help\|<provider>]`
`/brewtools:think-short`	Install/remove terse-mode hooks (SessionStart + every-10th UserPromptSubmit + subagent Task) that inject brevity directives; project or global	sonnet	`[<free-text prompt>] [Project\|Global]`
`/brewtools:task-board-init`	Deploy a self-contained file-based Kanban into ANY repo via multi-agent analysis (task-tracker agent + task-board skill + tasks rule + .claude/features/**)	opus	`[target repo path \| empty = cwd]`

Agents

Agent	Model	Purpose
text-optimizer	sonnet	Lean execution engine for text optimization with rule-based validation
ssh-admin	opus	Linux server administration -- SSH, Docker, firewalls, VPN, systemd, Caddy/Nginx
deploy-admin	opus	GitHub Actions, releases, GHCR, CI/CD, semver, deployment tracking

Architecture

brewtools/
+-- .claude-plugin/plugin.json        # Plugin manifest
+-- hooks/
|   +-- hooks.json                    # Hook registry
|   +-- session-start.mjs            # Manager HARD-wall awareness
|   +-- manager-prompt.mjs           # ++m / ++rr / ++r codeword injection
|   +-- 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/                   # Terse-mode hooks install/remove
|   +-- manager/                       # Codeword-triggered Manager mode + HARD delegation wall
|   +-- task-board-init/                # 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-brewcode marketplace but operate independently.

Hooks

Hook	Event	Purpose
`session-start.mjs`	SessionStart	Manager HARD-wall awareness -- injects guard tag into systemMessage and additionalContext
`manager-prompt.mjs`	UserPromptSubmit	Injects `++m` / `++rr` / `++r` manager codewords

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	manager
Plugin Update	plugin-update
Provider Switch	provider-switch
Think Short	think-short
Release Notes	RELEASE-NOTES.md

Author: Maksim Kochetkov | License: MIT

8.7 KiB Raw Permalink Blame History