GUIDE

On this page

Installation

These four products run in Claude Code: 27 skills, 10 agents, and 3 registered plugin hooks. The prompt below also installs the three brewcode mods, placeholders first, after it checks that Claude Code is 2.1.301 or newer.

Install prompt- if Claude refuses, paste this into the chat

First run `claude --version`. The mods need Claude Code 2.1.301 or newer. If it is lower, stop and tell me to run `claude update`, restart Claude Code (type `exit`, then run `claude`) and paste this prompt again.

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 brewmod-placeholders@claude-brewcode
3. claude plugin install brewmod-plan-effort@claude-brewcode
4. claude plugin install brewmod-reminders@claude-brewcode
5. claude plugin install brewcode@claude-brewcode
6. claude plugin install brewdoc@claude-brewcode
7. claude plugin install brewtools@claude-brewcode
8. 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.

Claude Code only

The repository keeps separate native instructions for Codex. This installation does not enable Codex plugins or change Codex authentication or runtime state.

Requirements

Component	Version	Purpose
Claude Code CLI	2.1.309 authoring reference	Runtime contracts checked for this release; not a declared minimum for the four plugins. The mods need 2.1.301 or newer
Node.js for plugins	20+	Plugin hook runtime
Node.js for mods	14.13.1+	Found automatically by the command-hook launcher; see Node runtime for supported locations and installation help
macOS	13+	Supported OS

macOS

Brewcode supports macOS only. Linux and Windows support is planned for future releases.

Installation methods

Marketplace (recommended)

Permanent installation through the Claude Code plugin system. Plugins load automatically with every session.

1. Update Claude Code — the mods need 2.1.301 or newer. Check claude --version; if it is lower, run claude update, then restart Claude Code (exit, then claude).

2. Add the marketplace — registers the plugin source:

claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode

3. Install the mods and the plugins — the three mods, then all four products, one name per command:

claude plugin install brewmod-placeholders@claude-brewcode
claude plugin install brewmod-plan-effort@claude-brewcode
claude plugin install brewmod-reminders@claude-brewcode
claude plugin install brewcode@claude-brewcode
claude plugin install brewdoc@claude-brewcode
claude plugin install brewtools@claude-brewcode
claude plugin install brewui@claude-brewcode

4. Reload the plugins — run /reload-plugins inside a session. If the command is unavailable, or you just ran claude update, type exit and run claude again.

Local directory (developers only)

Run from a cloned repository. Suitable for plugin development or one-off use.

1. Clone the repository:

git clone https://github.com/kochetkov-ma/claude-brewcode.git
cd claude-brewcode

2. Launch with the --plugin-dir flag:

claude --plugin-dir ./brewcode --plugin-dir ./brewdoc --plugin-dir ./brewtools --plugin-dir ./brewui

For a single plugin:

claude --plugin-dir ./brewcode
claude --plugin-dir ./brewtools
claude --plugin-dir ./brewui

Verifying the installation

Check the plugin list
Run /reload-plugins in your session (or restart Claude Code if the command is unavailable or you just ran claude update), then run the command below in your terminal. It lists brewmod-placeholders, brewmod-plan-effort, brewmod-reminders, brewcode, brewdoc, brewtools and brewui.
```
claude plugin list
```
Inspect project setup
Inside a session, the dashboard probes eleven setups and orders their commands by dependency. It never installs a setup; a stale one is upgraded only when you accept its offer or type upgrade.
```
/brewcode:setup-status
```
Build the foundation
Follow the dashboard, one setup per session, conventions before teams. See Full Setup.
```
/brewcode:convention-setup install
```

Mods

Brewcode mods are separate plugins that extend Claude Code itself through the hooks module API. They are counted apart from the four plugins, and the install above covers all three: brewmod-placeholders first, then brewmod-plan-effort and brewmod-reminders.

Update Claude Code first

The mods need Claude Code 2.1.301 or newer. Check with claude --version; if it is lower, run claude update and restart Claude Code (exit, then claude).

To add the mods to a machine that already has the plugins, run:

claude update
claude plugin marketplace update claude-brewcode
claude plugin install brewmod-placeholders@claude-brewcode
claude plugin install brewmod-plan-effort@claude-brewcode
claude plugin install brewmod-reminders@claude-brewcode

Restart Claude Code after claude update. When Claude Code was already 2.1.301 or newer, /reload-plugins is enough.

Updating #

Run /brewtools:plugin-update in a session to update every installed plugin and mod and offer the missing ones in one question, then /reload-plugins, then /brewcode:setup-status upgrade in each project.

Or run the update commands manually, then reload and upgrade as above. The mods need Claude Code 2.1.301 or newer: if claude --version is lower, run claude update and restart Claude Code first. Run one claude plugin update per installed plugin; a second name in one call is silently ignored:

claude plugin marketplace update claude-brewcode
claude plugin update brewmod-placeholders@claude-brewcode
claude plugin update brewmod-plan-effort@claude-brewcode
claude plugin update brewmod-reminders@claude-brewcode
claude plugin update brewcode@claude-brewcode
claude plugin update brewdoc@claude-brewcode
claude plugin update brewtools@claude-brewcode
claude plugin update brewui@claude-brewcode

Skip the lines of plugins you did not install.

Update prompt- if Claude refuses, paste this into the chat

First run `claude --version`. The mods need Claude Code 2.1.301 or newer. If it is lower, stop and tell me to run `claude update`, restart Claude Code (type `exit`, then run `claude`) and paste this prompt again.

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 brewmod-placeholders@claude-brewcode
3. claude plugin update brewmod-plan-effort@claude-brewcode
4. claude plugin update brewmod-reminders@claude-brewcode
5. claude plugin update brewcode@claude-brewcode
6. claude plugin update brewdoc@claude-brewcode
7. claude plugin update brewtools@claude-brewcode
8. claude plugin update brewui@claude-brewcode

If a command fails because that plugin is not installed, say so, treat it as done and continue with the next one.

After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Then, if brewcode is installed, tell me to run `/brewcode:setup-status upgrade` in this project and in each other project that uses brewcode. It upgrades the stale setups. Do not run it yourself: I type it. Run the commands now.

Troubleshooting #

Plugins don’t appear in claude plugin list: add the marketplace with claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode, reinstall and restart Claude Code.

/brewcode:* commands are not recognized: restart Claude Code. Plugins only load at session start.

timeout command missing on macOS: the semble-setup scripts use timeout/gtimeout when present and fall back to a pure-bash timer. brew install coreutils gives the native one.

Executable not found in $PATH: node in a mod hook: update the affected mod and run /reload-plugins to load its Node.js launcher. If no compatible runtime is installed, follow Node runtime. When the launcher cannot find Node.js, it skips the hook quietly and records a hint in <config dir>/logs/brewmod-node.log (<config dir> is CLAUDE_CONFIG_DIR, default ~/.claude) at most once per plugin per UTC day.

CLAUDECODE environment variable interferes with launch: run unset CLAUDECODE before claude in scripts (v0.2.47+).