grepai Skill
Environment: Ollama + bge-m3 | GOB storage | Java/Kotlin/JS/TS
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 args | MODE |
|---|---|
| upgrade, апгрейд | upgrade |
| optimize, update, улучши, обнови | optimize |
| stop, halt, kill | stop |
| start, watch | start |
| status, doctor, check, health | status |
| setup, configure, init | setup |
| reindex, rebuild, refresh | reindex |
| (empty) +.grepai/ exists | start |
| (empty) + no.grepai/ | setup |
| (unrecognized text) | prompt |
Prerequisites: Run /install 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:
| Parameter | Value |
|---|---|
subagent_type | brewcode:bc-grepai-configurator |
prompt | Configure grepai for this project. Analyze all build files, test patterns, source structure. Generate optimal.grepai/config.yaml. |
model | opus |
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.logPhase 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.logMode: 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:
| Parameter | Value |
|---|---|
subagent_type | brewcode:bc-grepai-configurator |
prompt | Re-analyze project and regenerate.grepai/config.yaml. Compare with existing config, optimize boost patterns, update trace languages. |
model | opus |
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.
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]