using-jambavanlisted

# Using Jambavan ## Overview Jambavan is an MCP server that provides AST-aware code indexing, token-budgeted context, durable memory, an inferred code graph, and guarded file/shell tools. It does not call an LLM — it gives *you* the ground to reason from. **Core principle:** Index first, context before reading, memory before repeating, failures before retrying. ## Session Protocol Use this sequence for a new project session: 1. **`jambavan_awaken {}`** — loads the protocol and recent project memories. If it reports an unresolved fallback, repeat with an eligible `{ "root": "/absolute/repo/path" }` before any stateful call. 2. **`jambavan_doctor {}`** — confirms the project root, gates, storage, and index/watcher status. 3. **`jambavan_index {}`** — builds or refreshes the AST-aware code index; it accepts the same optional existing absolute directory inside the unresolved fallback root, but cannot replace an already fixed binding. 4. **`jambavan_watch { "action": "start" }`** — keeps the index live while you edit (skip for one-shot tasks). 5. **`jambavan_context { "query": "<task-specific query>" }`** — pulls ranked, token-budgeted context before reading unfamiliar code. ## Quick Reference | Need | Tool | Key options | |------|------|-------------| | Understand unfamiliar code | `jambavan_context` | `query`, `compress_prose`, `include_diff`, `include_tests` | | Trace callers/callees | `jambavan_graph` | `action: query`, `query`, `direction` | | Find path between symbol