Troubleshooting
Common fixes for indexing, search, and MCP setup.
MCP shows no resources
Ensure `mikoshi-mcp` is enabled in your MCP config and restart Codex so it launches the server.
Indexing is slow or silent
The first run downloads the local model once. Subsequent indexing is incremental and faster.
Search returns nothing
Re-run `mikoshi index` on the same path and confirm files are not ignored by .gitignore.
Model download fails
Check your network. If you must stay offline, set `MIKOSHI_OFFLINE=1` and retry.