FAQ

Click any question to expand the answer. Use the table of contents on the right to jump straight to a specific question.

How do I update brewcode plugins?

Recommended: use the skill

Run the /brewtools:plugin-update skill inside any Claude Code session. It runs the full update chain automatically, reports versions, and prompts you to reload.

If the skill is unavailable (very old install, plugin not yet installed, or Claude refuses to invoke it), paste the prompt below directly into the chat — Claude Code will execute every command for you:

Update 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 update claude-brewcode
2. claude plugin update brewcode@claude-brewcode
3. claude plugin update brewdoc@claude-brewcode
4. claude plugin update brewtools@claude-brewcode
5. claude plugin update 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.

After all commands succeed, run /reload-plugins inside your Claude Code session. If /reload-plugins is unavailable, type exit and run claude again.

My install is too old — the skill isn't available

If /brewtools:plugin-update is missing (very old install or partial install), use the Claude Code prompt below. It tells Claude to run the marketplace update + every plugin update for you, no skill required:

Update 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 update claude-brewcode
2. claude plugin update brewcode@claude-brewcode
3. claude plugin update brewdoc@claude-brewcode
4. claude plugin update brewtools@claude-brewcode
5. claude plugin update 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.

After Claude finishes, the /brewtools:plugin-update skill will be available for all future updates.

Claude refuses to run the update commands

Paste the following prompt directly into the chat. The coercive phrasing is intentional — it prevents Claude from summarizing or skipping steps.

Update 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 update claude-brewcode
2. claude plugin update brewcode@claude-brewcode
3. claude plugin update brewdoc@claude-brewcode
4. claude plugin update brewtools@claude-brewcode
5. claude plugin update 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.

Easier alternative

Once any plugin update has succeeded, switch to the /brewtools:plugin-update skill — it handles refusal scenarios internally.

Which plugins are in the suite?
PluginPurposeInstall command
brewcodeConventions, rules, teams, deep review, semantic search: 9 skills, 5 agents, 2 hooksclaude plugin install brewcode@claude-brewcode
brewdocDocumentation tools: docsync-setup, memory-sync-setup, my-claude, PDF, publishing — 5 skills, 0 agents, 0 hooksclaude plugin install brewdoc@claude-brewcode
brewtoolsText utilities, SSH, deploy, plugin-update, manager mode, hook layer: 14 skills, 3 agents, 2 hooksclaude plugin install brewtools@claude-brewcode
brewuiUI/visual/creative tools (placeholder, empty): 0 skillsclaude plugin install brewui@claude-brewcode

All four plugins install from the same claude-brewcode marketplace on GitHub — 28 skills and 8 agents in total.

Why do some skills end in -setup?

A -setup suffix marks a skill that installs a mechanism into the project — agents, hooks, a generated skill, a board. After it runs you use the installed thing, not the skill. Skills without the suffix are recurring tools: running them repeatedly is the intended usage.

There are eleven -setup skills. They share one mode vocabulary — status | install | upgrade | enable | disable | uninstall | purge — and a bare invocation reports instead of installing once something is already there.

Skill-specific verbs come after the canonical set, never in place of it. All eleven setups implement all seven canonical verbs. Two mechanisms do the work: a live config flag that the reader re-checks on every invocation (semble, agent-deadline, agent-return, agent-router, manager, docsync), or entry-file parking, where the filename discovery keys on is renamed <name>.disabled with the body left byte-identical (teams, superreview, task-board, think-short, memory-sync).

Run them one at a time

Each setup is an interactive generator: it fans out subagents, analyses the repo and asks you real questions. Two in one session degrade each other. Start with /brewcode:setup-status and work its list, one setup per fresh session — full details on the Full Setup page.

Why does Claude never run these skills on its own?

Because that is the design. All 28 distributed skills carry both user-invocable: true and disable-model-invocation: true in their frontmatter. The model never sees their descriptions and never auto-activates one — a skill in this suite runs only when you type /plugin:skill.

This is a deliberate trade about context cost, not an oversight. Every skill whose description is model-visible spends tokens in every single request, forever, just to stay discoverable. Twenty-eight of them would be a permanent tax on the context window of every conversation, in exchange for auto-activation that these particular skills do not want anyway:

  • The eleven -setup skills are interactive generators that write real files into your repo. Nothing should reach for one without you asking.
  • The recurring tools (convention, rules, e2e, publish, text-optimize, secrets-scan, deploy, ssh) are things you run at a moment you choose, on a scope you choose.

The practical consequence: asking “can you sync my docs?” will not trigger /brewdoc:docsync-setup. Type the command. Tab completion after / lists everything that is installed.

Do I need to restart after updating?

Yes. Plugin changes only take effect after a reload.

  1. Preferred: reload in session

    Run /reload-plugins inside your active Claude Code session. This applies updates without closing the terminal.

  2. Fallback: restart the CLI

    Type exit to close the session, then run claude to start a new one. All updates will be picked up automatically.

How do I install missing plugins?

Paste the prompt below into any Claude Code session — Claude will add the marketplace and install all four plugins for you:

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.

After install

Once installed, manage updates with the /brewtools:plugin-update skill.

Where are plugins cached?

Plugins are stored locally after installation:

&#126;/.claude/plugins/cache/<marketplace>/<plugin>/<version>/

For example:

&#126;/.claude/plugins/cache/claude-brewcode/brewcode/5.0.0/
&#126;/.claude/plugins/cache/claude-brewcode/brewtools/5.0.0/

The marketplace metadata lives at:

&#126;/.claude/plugins/marketplaces/
How do I check my installed version?

Run /brewtools:plugin-update inside a Claude Code session. It reports the installed and latest available version for each plugin and prompts you to update if a newer version exists.

CLI version check (CC 2.1.163+)

Run claude plugin list (or claude plugin list —json for machine-readable output) to see installed plugins with their versions. Inside an active Claude session, prefix with unset CLAUDECODE && to avoid the env-var conflict. On CC older than 2.1.163 the command does not exist — use the cache directory path above or /brewtools:plugin-update as a fallback.