Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
kochetkov-ma avatar

Brewcode:Grepai

  • 19 installs
  • 29 repo stars
  • Updated August 2, 2026
  • kochetkov-ma/claude-brewcode

Helps with ai & agent building tasks.

About

brewcode:grepai is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

  • brewcode:grepai
  • AI & Agent Building
  • AI-coding skill

Brewcode:Grepai by the numbers

  • 19 all-time installs (skills.sh)
  • +1 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #10,587 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 3, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kochetkov-ma/claude-brewcode --skill brewcodegrepai

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs19
repo stars29
Last updatedAugust 2, 2026
Repositorykochetkov-ma/claude-brewcode

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

grepai Skill

Environment: Ollama + bge-m3 | GOB storage | Java/Kotlin/JS/TS

<instructions>

Mode Detection

Step 1: Detect Mode (MANDATORY FIRST STEP)

EXECUTE using Bash tool — detect mode from skill arguments:

bash "${CLAUDE_SKILL_DIR}/scripts/detect-mode.sh" "$ARGUMENTS"

Use $ARGUMENTS directly - it contains the skill invocation arguments.

Output format:

ARGS: [arguments received]
MODE: [detected mode]

Use the MODE value and GOTO that section below.

Mode Reference

Keyword in argsMODE
upgrade, апгрейдupgrade
optimize, update, улучши, обновиoptimize
stop, halt, killstop
start, watchstart
status, doctor, check, healthstatus
setup, configure, initsetup
reindex, rebuild, refreshreindex
(empty) + .grepai/ existsstart
(empty) + no .grepai/setup
(unrecognized text)prompt
Prerequisites: Run /brewcode:setup first to install brew, ollama, grepai, etc.

---

Mode: setup

Full grepai installation and project setup.

Phase 1: Infrastructure Check

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/infra-check.sh" && echo "✅ infra-check" || echo "❌ infra-check FAILED"
STOP if ❌ — install missing components before continuing.

Phase 2: MCP Configuration & Permissions

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/mcp-check.sh" && echo "✅ mcp-check" || echo "❌ mcp-check FAILED"

This script configures MCP server and allowedTools permissions.

STOP if ❌ — fix MCP configuration before continuing.

Phase 3: Generate Config

SPAWN the bc-grepai-configurator agent using Task tool:

ParameterValue
subagent_typebrewcode:bc-grepai-configurator
promptConfigure grepai for this project. Analyze all build files, test patterns, source structure. Generate optimal .grepai/config.yaml.
modelopus
Context: BC_PLUGIN_ROOT is available in agent context (injected by pre-task.mjs hook).
WAIT for agent to complete before proceeding.

Phase 4: Initialize Index

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/init-index.sh" && echo "✅ init-index" || echo "❌ init-index FAILED"
STOP if ❌ — check .grepai/logs/grepai-watch.log for errors.
Synchronous — Large projects (5k+ files) take 10-30+ min. Monitor: tail -f .grepai/logs/grepai-watch.log

Phase 5: Create Rule

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/create-rule.sh" && echo "✅ create-rule" || echo "❌ create-rule FAILED"
STOP if ❌ — manually create rule in .claude/rules/.

Phase 6: Verification

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/verify.sh" && echo "✅ verify" || echo "❌ verify FAILED"

---

Mode: status

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/status.sh" && echo "✅ status" || echo "❌ status FAILED"

---

Mode: start

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/start.sh" && echo "✅ start" || echo "❌ start FAILED"

---

Mode: stop

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/stop.sh" && echo "✅ stop" || echo "❌ stop FAILED"

---

Mode: reindex

Full index rebuild: stop watch → clean → rebuild → restart.

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/reindex.sh" && echo "✅ reindex" || echo "❌ reindex FAILED"
Synchronous — Monitor: `tail -f .grepai/logs/grepai-watch.log`

---

Mode: optimize

Re-analyze project and regenerate config with backup.

Step 1: Backup current config

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/optimize.sh" && echo "✅ optimize-backup" || echo "❌ optimize-backup FAILED"
STOP if ❌ — check if .grepai/config.yaml exists.

Step 2: Regenerate config

SPAWN the bc-grepai-configurator agent using Task tool:

ParameterValue
subagent_typebrewcode:bc-grepai-configurator
promptRe-analyze project and regenerate .grepai/config.yaml. Compare with existing config, optimize boost patterns, update trace languages.
modelopus
Context: BC_PLUGIN_ROOT is available in agent context (injected by pre-task.mjs hook).
WAIT for agent to complete.

Step 3: Reindex with new config

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/reindex.sh" && echo "✅ reindex" || echo "❌ reindex FAILED"

---

Mode: upgrade

Update grepai CLI via Homebrew.

EXECUTE using Bash tool:

bash "${CLAUDE_SKILL_DIR}/scripts/upgrade.sh" && echo "✅ upgrade" || echo "❌ upgrade FAILED"

---

Mode: prompt

Use AskUserQuestion to ask which operation to run:

header: "grepai"
question: "Which grepai operation do you want to run?"
options:
  - label: "setup"
    description: "Initialize and configure semantic search for this project"
  - label: "status"
    description: "Check health, index stats, doctor"
  - label: "start / watch"
    description: "Start watch mode (auto-index on file changes)"
  - label: "optimize"
    description: "Update and rebuild the search index"

For stop, reindex, upgrade — user types via Other. After answer, GOTO that mode section.

</instructions>

---

Output Format

# grepai [MODE]

## Detection

| Field | Value |
|-------|-------|
| Arguments | `$ARGUMENTS` |
| Mode | `[detected mode]` |

## Status

| Component | Status |
|-----------|--------|
| grepai CLI | [✅/❌] |
| ollama | [✅/❌] |
| bge-m3 model | [✅/❌] |
| MCP | [✅/❌] |
| Permissions | [✅/❌] allowedTools |
| .grepai/ | [✅/❌] |
| index | [size/indexing] |
| watch | [running/stopped] |
| rule | [✅/⚠️] |

## Actions Taken

- [action 1]
- [action 2]

## Next Steps

- [if any issues, list resolution steps]

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.