| name | query-workspace-kb |
| description | Search workspace-kb docs (kb_search) and shared project ops memory (kb_memory_*). Use for architecture, symptoms, env facts, and triage conclusions across Cursor/Codex/CLI. Not for personal preferences. |
Query workspace knowledge (aip-kb)
Where to look
| Need | Tool |
|---|
| Docs / skills / wiki | kb_search → kb_read |
| Shared ops facts / prior triage | kb_memory_search / kb_memory_put |
| Personal preference | Cursor Memories or Codex Memories (not kb_memory) |
| Team hard rules | AGENTS.md / rules (not memory) |
Docs flow
kb_search (limit 6–8). Note relatedMemories in the response.kb_read one cited heading; then rg only in that repo.- CLI fallback:
npx workspace-kb search -- "<query>".
Memory flow (cross Cursor + Codex + CLI)
- Before repeating an investigation:
kb_memory_search.
- After a durable, redacted conclusion:
kb_memory_put with tags + optional ttlDays (default 90).
- Audit/delete on the dashboard 项目记忆 panel.
Empty index: npx workspace-kb ingest. Dashboard: npx workspace-kb start.
Examples
kb_search query="充值未到账"
kb_memory_search query="fish37 hallapi"
kb_memory_put text="测服 hallapi HTTP 在 fish37:8080" tags=["ops","test-env"] ttlDays=90
npx workspace-kb memory list
