AI Assistant Integration
Step-by-step setup for Claude Code, OpenAI Codex, VS Code Copilot Chat, Cursor, git hooks, and MCP server mode.
Claude Code
Install
Run the installer once per project. It injects a /tracely360 slash command and writes a PreToolUse hook into .claude/settings.local.json.
tracely360 claude install
Build the graph
Open your project folder in Claude Code. Type the slash command:
/tracely360 .
# Or point to a specific folder:
/tracely360 ./src
Claude will confirm the extraction is complete and report god nodes, communities, and surprises.
Work with the graph
From now on, Claude consults GRAPH_REPORT.md before every file search via the PreToolUse hook. You can also query directly:
/tracely360 query "How does AuthService connect to the cache layer?"
/tracely360 path "DigestAuth" "Response"
/tracely360 explain "UserRepository"
Keep it fresh
Install git hooks to auto-rebuild on every commit:
tracely360 hook install
Or run tracely360 watch for real-time updates during active development.
OpenAI Codex (AGENTS.md)
Install
The installer writes the /tracely360 skill into AGENTS.md at the project root.
tracely360 codex install
Use
In Codex, invoke the skill:
/tracely360 .
/tracely360 --update
VS Code Copilot Chat
Install
tracely360 vscode install
This creates a .vscode/tracely360.instruction.md file that VS Code Copilot Chat picks up as a custom instruction.
Use
Open VS Code Copilot Chat panel. Type:
@workspace /tracely360 .
Cursor
Install
tracely360 cursor install
Creates a .cursorrules file (or appends to an existing one) with the tracely360 skill.
Use
In Cursor Agent or Chat, run:
/tracely360 .
MCP Server mode
Any MCP-compatible client (Claude Desktop, MCP Inspector, custom clients) can connect to tracely360 over stdio. Install the extra and start the server:
pip install tracely360[mcp]
# Start the MCP stdio server:
python -m tracely360.serve
# Or via tracely360 CLI:
tracely360 serve
The server exposes 7 MCP tools:
query_graphNatural language queryget_nodeFull node detailsget_neighborsAdjacency lookupget_communityCommunity membersgod_nodesTop connected nodesgraph_statsGraph summaryshortest_pathPath between nodesGit hooks
Install post-commit and post-checkout hooks to keep the graph up to date automatically. Compatible with Husky and custom core.hooksPath configurations.
tracely360 hook install
# Installs post-commit and post-checkout hooks
tracely360 hook status # check if hooks are installed
tracely360 hook uninstall # remove hooks
After each git commit or git checkout, tracely360 will automatically re-extract changed files (incremental, only processes what changed) and rebuild the graph. Subsequent assistant queries reflect the latest state.