Troubleshooting BoostGraph
Troubleshoot common BoostGraph issues with problem and solution guidance.
Use this topic to resolve common BoostGraph issues.
BoostGraph Not Initialized
Problem: BoostGraph hooks or the index are not set up for the repository.
Solution: Run boost init so session-start hooks are registered, then open the project with your coding agent. Indexing should start automatically. For immediate indexing, run boost graph init in the repository root.
Slow Indexing
Problem: First-time indexing on a large repository takes longer than expected.
Solution: Indexing runs in the background and does not block your agent. No action is required unless you need the index immediately. In that case, run boost graph init in the repository root to pre-build the graph.
Agent Still Greps Instead of Using BoostGraph
Problem: The agent searches files with grep instead of calling boostgraph_explore.
Solution: The index may still be building, or the MCP may not be connected yet. Restart your agent and use /mcp to verify the MCP is connected.
Related Topics
Updated 7 days ago