diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 8c305b9..14b4bf4 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -251,10 +251,13 @@ Tier 0 — **Ollama is the documentation engine.** Route all prose generation th ### GrepAI (Semantic Code Search) -Use for intent-based search ("how does auth work"), exploring unfamiliar code, context recovery. -- **MCP tool:** `grepai` server tools -- **Agent:** `deep-explore` agent -- **CLI:** `grepai search "query" --json --compact` +**Use GrepAI first for any context lookup before reading files directly.** It indexes all session logs, skill files, and project docs with boosted relevance for `.claude/` and `session-logs/`. + +- **When to use:** "what did we do with X", "how does Y work", "find where Z is configured", context recovery, exploring unfamiliar code +- **MCP tools:** `grepai_search` (primary), `grepai_trace_callers`, `grepai_trace_callees` +- **Agent:** `deep-explore` (for multi-hop exploration) +- **CLI:** `D:/claudetools/grepai.exe search "query" --json -c -n 5` +- **Watcher:** runs as scheduled task "GrepAI Watcher - claudetools" (auto-starts on login, keeps index current) --- diff --git a/.claude/OLLAMA.md b/.claude/OLLAMA.md index f2cb7e5..6e720d1 100644 --- a/.claude/OLLAMA.md +++ b/.claude/OLLAMA.md @@ -96,6 +96,37 @@ This keeps Claude tokens focused on reasoning, decisions, and execution. Ollama - Security decisions, auth review, production migrations - Final field values on API payloads (rates, IDs, quantities) +### GrepAI config (re-apply on new machines) + +`.grepai/` is gitignored (90 MB index + machine-specific timestamps). After running `grepai init` on a new machine, apply these overrides to `.grepai/config.yaml`: + +**Remove the `.md` penalty** (markdown is primary content here, not docs noise): +```yaml +# DELETE this block: +- pattern: .md + factor: 0.6 +``` + +**Add these bonuses** under `search.boost.bonuses`: +```yaml +- pattern: session-logs/ + factor: 1.3 +- pattern: .claude/ + factor: 1.2 +- pattern: /clients/ + factor: 1.1 +``` + +**Start watcher + register scheduled task:** +```bash +D:/claudetools/grepai.exe watch --background +# Then in PowerShell (admin not required): +$action = New-ScheduledTaskAction -Execute "D:\claudetools\grepai.exe" -Argument "watch --background" -WorkingDirectory "D:\claudetools" +$trigger = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME +$settings = New-ScheduledTaskSettingsSet -ExecutionTimeLimit (New-TimeSpan -Hours 0) -MultipleInstances IgnoreNew +Register-ScheduledTask -TaskName "GrepAI Watcher - claudetools" -Action $action -Trigger $trigger -Settings $settings -Force +``` + ### Warm-start and GrepAI GrepAI uses `nomic-embed-text` for context lookups, which keeps the Ollama **service** running continuously. The 30-50s service cold-start is effectively eliminated in normal workflow. `qwen3:14b` may take ~5s to swap into VRAM if it hasn't been called recently, but that's the worst case — not 50s.