brewcode:install
npx machina-cli add skill kochetkov-ma/claude-brewcode/install --openclawbrewcode Install
Interactive installer for brewcode prerequisites.
<instructions>Components
| Component | Type | Purpose |
|---|---|---|
| brew | required | Package manager |
| coreutils+timeout | required | Command timeout for scripts |
| jq | required | JSON processor for hooks |
| ollama | optional | Local embedding server |
| bge-m3 | optional | Multilingual embedding model (~1.2GB) |
| grepai | optional | Semantic code search CLI |
Workflow
Phase 1: State Check
EXECUTE: bash scripts/install.sh state
Phase 2: Updates Check
EXECUTE: bash scripts/install.sh check-updates
If UPDATES_AVAILABLE=true → ASK (AskUserQuestion):
- Header: "Updates"
- Question: "Updates available: [list from output]. Update now?"
- Options: "Yes, update all" | "Skip"
If Yes → EXECUTE: bash scripts/install.sh update-all
Phase 3: Timeout Check
EXECUTE: bash scripts/install.sh check-timeout
If TIMEOUT_EXISTS=false → ASK:
- Header: "Timeout Symlink"
- Question: "Create 'timeout' symlink? REQUIRED for brewcode."
- Options: "Yes, create" | "No, cancel"
If cancel → STOP: "Installation cancelled. timeout command required."
Phase 4: Required Components
EXECUTE: bash scripts/install.sh required
If timeout still missing → EXECUTE: bash scripts/install.sh timeout
STOP if any required failed.
Phase 5: Semantic Search (Optional)
If not installed → ASK:
- Header: "grepai"
- Question: "Install semantic search? Enables AI-powered code search."
- Options: "Yes, install (~1.5GB)" | "Skip"
If Yes → EXECUTE: bash scripts/install.sh grepai
Phase 6: Summary
EXECUTE: bash scripts/install.sh summary
Source
git clone https://github.com/kochetkov-ma/claude-brewcode/blob/main/brewcode/skills/install/SKILL.mdView on GitHub Overview
brewcode:install is an interactive installer that sets up the required prerequisites for BrewCode, including brew, coreutils, jq, and grepai, with optional components like ollama and bge-m3. It guides users through a phased workflow (state, updates, timeout, required components, and optional semantic search) to ensure a reliable setup.
How This Skill Works
The installer runs a scripted workflow (bash scripts/install.sh) across six phases: check state, check updates with prompts, ensure a timeout and required components, optionally install grepai, then present a summary. User decisions drive execution, with prompts to update, create timeout symlink, and install optional features.
When to Use It
- Setting up a fresh development environment for BrewCode that requires brew, coreutils, jq, and grepai.
- Reconfiguring or updating prerequisites after system changes or OS updates.
- Enabling semantic code search by installing grepai as part of the setup.
- Ensuring a proper timeout utility is available for script execution during install.
- Onboarding teammates with a repeatable, interactive installer for consistent environments.
Quick Start
- Step 1: Open your terminal and run the brewcode:install installer.
- Step 2: Follow the prompts to install required components and optional features like grepai.
- Step 3: Review the summary to confirm a successful setup and proceed with development.
Best Practices
- Run the installer in a clean shell session to avoid conflicts with ongoing processes.
- Verify that the required components are supported by your OS before installation.
- Carefully respond to updates and timeout prompts to avoid unnecessary changes.
- Install required components first, then consider optional ones like grepai or ollama.
- After installation, review the summary to confirm all desired components are installed.
Example Use Cases
- A developer on macOS runs brewcode:install to prepare a fresh machine for BrewCode development.
- A CI environment uses the installer to provision a build agent with consistent prerequisites.
- A team onboarding session uses the installer to provide new members with a ready-to-use setup.
- An engineer updates the environment and reruns the installer to apply new prerequisites.
- An engineer enables semantic search by choosing to install grepai during setup.
