Ask your agent one question

This is the shortest path from an empty checkout to one real question. It uses the open-source engine on your machine. You need Python 3.10 or later and a supported coding assistant.

Install and check the version

uv tool install graphifyy
graphify --version

graphify --version prints the version you installed. The latest release is on PyPI and in the changelog. The package is graphifyy, with two y’s. The command is graphify.

Install the skill for your assistant

graphify install --platform cursor

Use claude, codex, gemini, or copilot in place of cursor when that is the assistant. graphify install with no flag uses the assistant it detects. Copilot in VS Code uses graphify vscode install. See all integrations.

Map the repository

In the assistant chat, at the repository root:

/graphify .

In Codex, select the Graphify skill with $graphify and ask it to map the current repository. This is an assistant instruction, not a shell command.

Check the files

A finished map writes graphify-out/ at the repository root:

graphify-out/
├── graph.html        Interactive graph
├── GRAPH_REPORT.md   Concepts, communities, and suggested questions
└── graph.json        The graph used by CLI and MCP queries

Ask one question

graphify query "how does authentication reach the database?"

The first line names the graph and the nodes the search started from. Each NODE line is a concept with its source file and line. Each EDGE line is a relationship and where it happens in the code. If the output says TRUNCATED, raise --budget or ask about a narrower name.This is graph context from the files Graphify analyzed, not a verified answer. Open the source lines it cites before you rely on it.

If a step fails

What you see	What to do
The shell cannot find `graphify`	Run `uv tool update-shell`, then open a new terminal. See Troubleshooting.
No `graphify-out/` after `/graphify .`	Run it in the assistant chat at the repository root, not in a shell. See When something fails.
The query returns nothing useful	Ask about a function, class, or file in this repository. If the code changed since the map, run `graphify update .` first.

Next steps

Trace who calls this

Find the callers of a symbol and check whether two names connect.

Query reference

Every flag graphify query accepts.

Guides

Team workflows

Ask your agent one question

If a step fails

Next steps

Trace who calls this

Query reference

​If a step fails

​Next steps

Trace who calls this

Query reference

If a step fails

Next steps