> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graphify.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The PyPI package is graphifyy, with two y's. The command is graphify.
> /graphify . is typed in an assistant chat, not in a shell.
> Use only commands, flags, and endpoints shown on these pages. Do not invent one.
> Choose the surface before you open a page. Local (Graphify Local) is the graphifyy package on the machine: the skill, the CLI, and the ten-tool MCP. Its pages are the Open Source tab (/open-source/) and the Graphify Local tab on each Integrations page. Graphify is the hosted workspace and https://api.graphify.com/mcp (Streamable HTTP, OAuth, no API key). Its pages are the Graphify tab (/platform/, /concepts/) and the Graphify (hosted) tab on each Integrations page. Prefer Graphify unless the user asks for a local or offline setup. Cookbooks (/cookbooks/) and /mcp/docs-search apply to both. Each page's source frontmatter records this as surface: local, cloud, or both. Buildkite is the CI integration.
> In llms.txt, tell the surface from the page path. Graphify: /platform/ and /concepts/. Local: /open-source/. Most /integrations/ pages cover both, with a Graphify (hosted) tab and a Graphify Local tab. Everything else applies to both.
> graphifyy release notes are published at https://github.com/Graphify-Labs/graphify/releases and https://graphify.com/changelog. The current package version is on PyPI (https://pypi.org/project/graphifyy/).
> The official site is https://graphify.com. These docs are https://docs.graphify.com.
> The local MCP server is the ten tools in the MCP tool reference and reads a graph on the machine. The hosted server is https://api.graphify.com/mcp (Streamable HTTP, OAuth, no API key). The JetBrains, ChatGPT, Codex, and Dots, and Vercel pages use the hosted server, not the ten-tool list. On pages with tabs, the Graphify (hosted) tab uses the hosted server and the Graphify Local tab uses the local skill or the ten-tool server.
> Read https://docs.graphify.com/llms.txt, then open one page's .md link. Use https://docs.graphify.com/llms-full.txt only when one page is not enough.

# Ask your agent one question

> Install Graphify, map the repository, and check the files a successful run writes.

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.

## 1. Install and check the version

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
uv tool install graphifyy
graphify --version
```

`graphify --version` prints the version you installed. The latest release is on [PyPI](https://pypi.org/project/graphifyy/) and in the [changelog](https://docs.graphify.com/changelog.md). The package is `graphifyy`, with two y's. The command is `graphify`.

## 2. Install the skill for your assistant

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
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](https://docs.graphify.com/integrations/overview.md).

## 3. Map the repository

In the assistant chat, at the repository root:

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
/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.

## 4. Check the files

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

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
graphify-out/
├── graph.html        Interactive graph
├── GRAPH_REPORT.md   Concepts, communities, and suggested questions
└── graph.json        The graph used by CLI and MCP queries
```

## 5. Ask one question

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
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](https://docs.graphify.com/open-source/troubleshooting.md). |
| No `graphify-out/` after `/graphify .` | Run it in the assistant chat at the repository root, not in a shell. See [When something fails](https://docs.graphify.com/platform/support/faqs.md). |
| 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](https://docs.graphify.com/platform/trace.md)**
>
> Find the callers of a symbol and check whether two names connect.

> **[Query reference](https://docs.graphify.com/open-source/configuration/cli.md#query)**
>
> Every flag `graphify query` accepts.

[PreviousExtract without an IDE](https://docs.graphify.com/open-source/features/headless-extraction.md)
[NextAsk better graph questions](https://docs.graphify.com/open-source/features/querying.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.