Installation

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

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

Local directory

Run from a cloned repository. Suitable for 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

For a single plugin:

claude --plugin-dir ./brewcode

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 and brewdoc in the list.
Install dependencies
Inside a Claude Code session, run:
```
/brewcode:install
```
This skill checks for and installs brew, jq, and coreutils. Optionally installs ollama and grepai for semantic search.

Updating

Already have Brewcode installed? Update to the latest version:

claude plugin marketplace update claude-brewcode
claude plugin update brewcode@claude-brewcode
claude plugin update brewdoc@claude-brewcode

Restart Claude Code after updating.

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:install reports missing timeout — The skill creates a symlink automatically. 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

Plugins are installed. Head to Quick Start to run your first task in 15 minutes.