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 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.

Requirements

Component	Version	Purpose
Claude Code CLI	latest	Plugin runtime
Node.js	20+	Hook runtime
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. Add the marketplace — registers the plugin source:

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

2. Install the plugins — copies both plugins to the local cache:

claude plugin install brewcode@claude-brewcode
claude plugin install brewdoc@claude-brewcode
claude plugin install brewtools@claude-brewcode
claude plugin install brewui@claude-brewcode

3. Restart Claude Code — the plugins will load automatically.

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 (developers only):

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

For a single plugin (developers only):

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

Verifying the installation

Install the plugins
Run the commands from the section above. Restart Claude Code after installation.
Check the plugin list
In your terminal, run:
```
claude plugin list
```
You should see brewcode, brewdoc, brewtools, and brewui in the list.
Run project setup
Inside a Claude Code session, run:
```
/brewcode:setup
```
Setup automatically checks and installs prerequisites (brew, jq, coreutils) as Phase 0 before analyzing your project. Optionally installs ollama and grepai for semantic search.

Updating

Already have Brewcode installed? Update to the latest version:

Easy path: plugin-update skill

Run /brewtools:plugin-update inside a Claude Code session. It checks versions, runs the full update chain, and prompts you to reload — no manual commands needed.

Or run the update commands manually:

claude plugin marketplace update 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

After updating: reload required

Run /reload-plugins inside your session (preferred), or type exit and run claude again (fallback). Updates are not active until a reload.

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.

Troubleshooting

Common issues

Plugins don’t appear in claude plugin list — Make sure the marketplace is added: claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode. Reinstall and restart Claude Code.

/brewcode:* commands are not recognized — Restart Claude Code after installation. Plugins only load at session start.

/brewcode:setup reports missing timeout — The setup skill creates a symlink automatically during Phase 0. If the issue persists: brew install coreutils.

CLAUDECODE environment variable interferes with launch — Run unset CLAUDECODE before running claude in scripts (applies to v0.2.47+).

Next step

🚀