Brewtools Overview

Brewtools is a lightweight plugin providing universal utilities: token-efficient optimization, AI-artifact removal, secrets scanning, SSH server management, and GitHub Actions deployment. Each skill is self-contained and requires no prior setup.

Installation

Install prompt

If Claude refuses to run the commands, paste the prompt below directly into the chat. 
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 brewtools@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.

Install the entire suite:

Install prompt

If Claude refuses to run the commands, paste the prompt below directly into the chat. 
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.

Skills (recipes)

✨

text-optimize

LLM token efficiency optimization with 30+ validated rules. Three modes: light, medium, deep. Parallel file processing.

👤

text-human

Remove AI artifacts from code and docs: comments, fake issue numbers, unicode characters, trivial documentation. Commit, file, or folder scope.

🔒

secrets-scan

Security audit for leaked credentials in git-tracked files. 10 parallel agents, severity classification, interactive remediation.

📟

ssh

SSH server management — connect, configure, deploy, administer remote Linux servers with safety gates and confirmation prompts.

🔄

deploy

GitHub Actions deployment — workflows, releases, GHCR, CI/CD pipelines with safety gates and rollback support.

🔄

plugin-update

Check, install, and update the full brewcode plugin suite in one command. Version status table, install missing plugins, reload prompt.

🔄

provider-switch

Configure alternative API providers — DeepSeek V4 (priority), Z.ai/GLM, Qwen, MiniMax, OpenRouter. Shell aliases in ~/.zshrc, one-command switching, validated model selection.

Commands

CommandPurposeModelArguments
/brewtools:text-optimizeOptimize text for LLM token efficiencysonnet[-l|-d] [file|folder|path1,path2]
/brewtools:text-humanRemove AI artifacts from code and docssonnet<commit-hash|path> [custom instructions]
/brewtools:secrets-scanScan for leaked secrets and credentialssonnet[--fix]
/brewtools:sshSSH server managementopus[connect|configure|deploy|admin]
/brewtools:deployGitHub Actions deployment, CI/CDopus[workflow|release|ghcr]
/brewtools:plugin-updateCheck and update the full brewcode plugin suitesonnet[check|update|all]
/brewtools:provider-switchConfigure alternative API providersopus[status|setup|help|<provider>]

Agent

AgentModelPurpose
text-optimizersonnetLean execution engine for text optimization with rule-based validation
ssh-adminopusSSH server administration, configuration, deployment
deploy-adminopusGitHub Actions, CI/CD, releases, GHCR management

Plugin variable

Plugin paths resolve natively via ${CLAUDE_PLUGIN_ROOT} at Task spawn — no hook injection required. Skills in the main conversation use ${CLAUDE_SKILL_DIR} to access their own files; subagents receive ${CLAUDE_PLUGIN_ROOT} as a built-in variable from Claude Code.

Architecture

brewtools/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest
├── hooks/
│   ├── hooks.json               # Hook registry
│   ├── session-start.mjs        # SessionStart: HARD-wall awareness, manager codeword prep
│   ├── manager-prompt.mjs       # UserPromptSubmit: ++m / ++a / ++rr / ++r codewords
│   └── 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/           # Check, install, and update plugin suite
│   └── provider-switch/          # Alternative API provider management
└── agents/
    ├── text-optimizer.md        # Text optimization agent
    ├── ssh-admin.md             # SSH server administration
    └── deploy-admin.md          # GitHub Actions, CI/CD agent

Brewtools vs Brewcode

Brewtools provides standalone text utilities: optimization, humanization, security scanning. Each skill works independently with no lifecycle dependencies.

Brewcode is a task execution engine with infinite context, lifecycle hooks, KNOWLEDGE.jsonl, and session handoff.

Both plugins install from the same claude-brewcode marketplace but operate independently.

🚀

Latest Release

Download, changelog, and installation instructions.

📖

Installation Guide

Full setup, update, and troubleshooting instructions.

🔗

View on GitHub

Source code, README, and configuration files.