CLI
The dokkai CLI
A Node/TypeScript command line for the API and the MCP server: ingest a repo with live progress, export the graph, or launch a coding agent with dokkai retrieval wired in.
Install
bash
cd cli
npm install
npm run build
npm link # `dokkai` is now on PATHWill be available as
npm install -g dokkai once published — for now, npm link from cli/.Commands
| Command | What it does |
|---|---|
dokkai up [--full] | Bring up Weaviate/Postgres/Memgraph (or the whole stack with --full) and report reachability. |
dokkai status | Read-only health check plus a list of ingested projects. |
dokkai ingest <repo> | Run the full pipeline with live stage progress over SSE. |
dokkai graph <repo|project> | Graph-only run, or fetch a project's normalized structural graph. |
dokkai srcs --model <…> | Launch a SRCS session: Claude Code, Codex, or a local Ollama loop. |
dokkai watch <repo> | Debounced incremental re-ingestion on every save. |
dokkai doctor | Diagnose the local toolchain and print the exact fix command for each issue. |
Global flag: --api <url> — dokkai API URL (default http://localhost:8000). Precedence: --api > DOKKAI_API_URL env var > repo .env > default.
Something not working?
dokkai doctor checks node, docker, uv, DOKKAI_HOME and Weaviate/Ollama/API reachability, and prints the exact command to fix whatever's missing.