Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions agents/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Default to the hosted server. Use open-source Graphify only when the user asks f

| Path | Use when | Setup |
| --- | --- | --- |
| Hosted MCP server | Default. The user's repositories are indexed at [app.graphify.com](https://app.graphify.com). | Add `https://api.graphify.com/mcp` as a remote Streamable HTTP server. Sign-in is OAuth in the browser; there is no API key. Commands per agent: [Setup for AI agents](/for-agents#setup-for-ai-agents), step 2. |
| Hosted MCP server | Default. The user's repositories are indexed at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=agents-overview). | Add `https://api.graphify.com/mcp` as a remote Streamable HTTP server. Sign-in is OAuth in the browser; there is no API key. Commands per agent: [Setup for AI agents](/for-agents#setup-for-ai-agents), step 2. |
| One-click installs and plugins | The user prefers to click instead of editing config. | [Install in Cursor](/integrations/cursor), the [VS Code extension](/integrations/vscode), and the [Graphify plugin for ChatGPT and Codex](/integrations/chatgpt). All three connect to the same hosted server. |
| Graphify CLI | The user asks for an offline or on-machine graph. | `uv tool install graphifyy`, then `graphify install`. See the [Graphify CLI quickstart](/open-source/quickstart). Its MCP server has [ten tools](/open-source/features/mcp-tools) with different names from the hosted ones. |

Expand Down Expand Up @@ -85,7 +85,7 @@ You can add the server, but only the user can finish the OAuth sign-in in a brow
4. Meanwhile, answer from the local files and say that the answer did not come from Graphify.
5. After sign-in, call `list_repositories` and show the result.

If `list_repositories` succeeds but is empty, sign-in worked and no repository is indexed in this workspace. Ask the user to index one at [app.graphify.com](https://app.graphify.com) or switch workspace.
If `list_repositories` succeeds but is empty, sign-in worked and no repository is indexed in this workspace. Ask the user to index one at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=agents-overview) or switch workspace.

## Related

Expand Down
4 changes: 2 additions & 2 deletions changelog/highlights.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -148,7 +148,7 @@ Nothing moved that you depended on. Every page is where it was, and easier to re
<Update label="2026-09-02" description="Teams, and switching between workspaces">
## Teams, and switching between workspaces

The **Teams** plan lets your whole team share one Graphify workspace, with a seat for each developer. Start it at [signup](https://app.graphify.com/signup): choose how many seats you need and check out with Stripe.
The **Teams** plan lets your whole team share one Graphify workspace, with a seat for each developer. Start it at [signup](https://app.graphify.com/signup?utm_source=docs&utm_medium=link&utm_campaign=changelog-highlights): choose how many seats you need and check out with Stripe.

When you upgrade, you can turn your current workspace into a team workspace and keep its repositories, graphs, memory and address. Or you can create a new team workspace. Invite teammates from **Members** in the user menu at the bottom of the sidebar. Owners and admins of a team workspace see there how many seats are in use.

Expand Down Expand Up @@ -229,7 +229,7 @@ Now Graphify tells you which workspace owns the installation and lets you reques
Graphify now has two plans.

- **Free** lets you sign in, connect a repository and use the console.
- **Pro** raises the limits for larger repositories and teams. Start Pro at [signup](https://app.graphify.com/signup) and check out for a single seat.
- **Pro** raises the limits for larger repositories and teams. Start Pro at [signup](https://app.graphify.com/signup?utm_source=docs&utm_medium=link&utm_campaign=changelog-highlights) and check out for a single seat.

The plan you are on shows in the console, and limits explain themselves when you reach them, with a link to upgrade.

Expand Down
2 changes: 1 addition & 1 deletion changelog/local.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The open-source package, `graphifyy`, ships new versions often, sometimes severa

<div className="not-prose mt-6 grid grid-cols-1 gap-4 md:grid-cols-2">
<a href="https://github.com/Graphify-Labs/graphify/releases" className="group flex flex-col rounded-xl border border-[#d6e5dc] dark:border-[#262626] !border-b-[#d6e5dc] dark:!border-b-[#262626] bg-[#ffffff] dark:bg-[#141515] p-6 no-underline transition-colors hover:border-[#94b6a2] dark:hover:border-[#404040] hover:bg-[#edf6f0] dark:hover:bg-[#1c1d1d] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[#4dea9c]"><span className="text-[11px] font-medium uppercase tracking-[0.08em] text-[#1f8a55] dark:text-[#4dea9c]">GitHub</span><span className="mt-2 text-base font-semibold text-[#062314] dark:text-[#ededed]">GitHub releases</span><span className="mt-2 text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Full release notes and tags for every version of the open-source repo.</span><span className="mt-4 text-sm font-medium text-[#254d37] dark:text-[#d4d4d4]">View releases ↗</span></a>
<a href="https://graphify.com/changelog" className="group flex flex-col rounded-xl border border-[#d6e5dc] dark:border-[#262626] !border-b-[#d6e5dc] dark:!border-b-[#262626] bg-[#ffffff] dark:bg-[#141515] p-6 no-underline transition-colors hover:border-[#94b6a2] dark:hover:border-[#404040] hover:bg-[#edf6f0] dark:hover:bg-[#1c1d1d] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[#4dea9c]"><span className="text-[11px] font-medium uppercase tracking-[0.08em] text-[#1f8a55] dark:text-[#4dea9c]">graphify.com</span><span className="mt-2 text-base font-semibold text-[#062314] dark:text-[#ededed]">Website changelog</span><span className="mt-2 text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">A readable summary of each release, newest first.</span><span className="mt-4 text-sm font-medium text-[#254d37] dark:text-[#d4d4d4]">Read the changelog ↗</span></a>
<a href="https://graphify.com/changelog?utm_source=docs&utm_medium=link&utm_campaign=changelog-local" className="group flex flex-col rounded-xl border border-[#d6e5dc] dark:border-[#262626] !border-b-[#d6e5dc] dark:!border-b-[#262626] bg-[#ffffff] dark:bg-[#141515] p-6 no-underline transition-colors hover:border-[#94b6a2] dark:hover:border-[#404040] hover:bg-[#edf6f0] dark:hover:bg-[#1c1d1d] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[#4dea9c]"><span className="text-[11px] font-medium uppercase tracking-[0.08em] text-[#1f8a55] dark:text-[#4dea9c]">graphify.com</span><span className="mt-2 text-base font-semibold text-[#062314] dark:text-[#ededed]">Website changelog</span><span className="mt-2 text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">A readable summary of each release, newest first.</span><span className="mt-4 text-sm font-medium text-[#254d37] dark:text-[#d4d4d4]">Read the changelog ↗</span></a>
</div>

<Visibility for="humans">
Expand Down
2 changes: 1 addition & 1 deletion concepts/ask-about-your-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Use this when you know what you want to understand but not where it lives. If yo

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-ask-about-your-code). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- A repository with the status **Indexed**. See [Repositories and builds](/platform/repositories).
- Your agent connected to the hosted MCP server at `https://api.graphify.com/mcp`. See [Code with an agent](/cookbooks/cloud-coding-agents).

Expand Down
2 changes: 1 addition & 1 deletion concepts/check-impact.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Use this while you plan a change. After you open a pull request, [pull request r

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-check-impact). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- A repository with the status **Indexed**. See [Repositories and builds](/platform/repositories).
- Your agent connected to the hosted MCP server at `https://api.graphify.com/mcp`. See [Code with an agent](/cookbooks/cloud-coding-agents).

Expand Down
2 changes: 1 addition & 1 deletion concepts/colliding-pull-requests.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Two pull requests can both pass review and still collide when they change the sa

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-colliding-pull-requests). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- For the local commands, the open-source CLI. See [Installation](/open-source/installation).
- A repository with the status **Indexed**, or a local graph at `graphify-out/graph.json`.
- For the local commands, the [GitHub CLI](https://cli.github.com) signed in to the repository. `graphify prs` reads open pull requests through it.
Expand Down
2 changes: 1 addition & 1 deletion concepts/follow-calls.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Use this when you already know a symbol and want to see what is around it. If yo

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-follow-calls). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- A repository with the status **Indexed**. See [Repositories and builds](/platform/repositories).
- Your agent connected to the hosted MCP server at `https://api.graphify.com/mcp`. See [Code with an agent](/cookbooks/cloud-coding-agents).

Expand Down
2 changes: 1 addition & 1 deletion concepts/how-graphify-is-different.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Graphify is a **code knowledge graph**. It reads your code, records the symbols
Other tools help agents and people understand code too. They answer different questions, and they often work well together.

<Tip>
**Try it on your own repo.** [Start with hosted Graphify](https://app.graphify.com), or build a graph locally with `uv tool install graphifyy`.
**Try it on your own repo.** [Start with hosted Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-how-graphify-is-different), or build a graph locally with `uv tool install graphifyy`.
</Tip>

## At a glance
Expand Down
2 changes: 1 addition & 1 deletion concepts/index-a-repository.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Indexing turns a repository into a graph that Graphify and your agent can query.

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-index-a-repository). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- Permission to grant the Graphify app access to the repository on GitHub or GitLab.

## Index the repository
Expand Down
2 changes: 1 addition & 1 deletion concepts/review-a-pull-request.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Reviews are advisory. They don't block a merge.

## Before you start

- An account at [app.graphify.com](https://app.graphify.com). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- An account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=concepts-review-a-pull-request). The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.
- A repository with the status **Indexed**. See [Repositories and builds](/platform/repositories).
- **PR reviews** switched on for the repository. It is on unless someone turned it off in **Repositories** > **Options**.

Expand Down
2 changes: 1 addition & 1 deletion cookbooks/agent-team-one-graph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ A solo founder runs one product across three repositories: a web app, an API and

## Before you start

- Your repositories indexed in one [Graphify](https://app.graphify.com) workspace.
- Your repositories indexed in one [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-agent-team-one-graph) workspace.
- The agents you use. Setup for each client is in [Graphify MCP](/platform/graphify-mcp).

## Setup
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/cross-repo-dependencies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ flowchart LR

## Setup

- A Graphify account at [app.graphify.com](https://app.graphify.com), connected to GitHub or GitLab. See the [Quickstart](/platform/quickstart).
- A Graphify account at [app.graphify.com](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-cross-repo-dependencies), connected to GitHub or GitLab. See the [Quickstart](/platform/quickstart).
- Each repository you want to combine added and showing **Indexed** in **Repositories**. See [Repository indexing](/platform/repositories).
- A coding agent that supports remote MCP servers, such as Claude Code, Codex, Cursor or VS Code.

Expand Down
2 changes: 1 addition & 1 deletion cookbooks/document-the-why.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ import TryCloudCard from '/snippets/try-cloud-card.mdx';

## Before you start

- A repository indexed in [Graphify](https://app.graphify.com), with your coding agent connected to the [hosted MCP server](/platform/graphify-mcp). The open-source [Graphify CLI](/open-source/overview) works too.
- A repository indexed in [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-document-the-why), with your coding agent connected to the [hosted MCP server](/platform/graphify-mcp). The open-source [Graphify CLI](/open-source/overview) works too.
- Access to your git history and issue tracker.

## Why AI coding agents "fix" code that isn't broken
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/fix-review-findings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ A two-person team ships most changes through Claude Code. Graphify reviews every

## Before you start

- A repository indexed in [Graphify](https://app.graphify.com) with **PR reviews** on. See [Pull request reviews](/platform/reviews).
- A repository indexed in [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-fix-review-findings) with **PR reviews** on. See [Pull request reviews](/platform/reviews).
- A coding agent connected to the hosted MCP server. See [Connect cloud coding agents to hosted MCP](/cookbooks/cloud-coding-agents).
- The GitHub CLI (`gh`) signed in on the machine where the agent runs.
- You're an owner, member or collaborator on the repository. Only they can start a review with a comment.
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/govern-codebase-non-engineer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ A founder runs a product built mostly by coding agents and one freelance develop

## Before you start

- Your repository indexed in [Graphify](https://app.graphify.com). See [Quickstart](/platform/quickstart).
- Your repository indexed in [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-govern-codebase-non-engineer). See [Quickstart](/platform/quickstart).
- Reviews on for the repository. They are unless someone turned **PR reviews** off in **Options** on **Repositories**.

## Setup
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/policy-docs-next-to-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ A small team builds software for a regulated industry. Their policies sit in a s

- A paid Graphify plan. Adding Drive folders needs one.
- An owner or admin to connect Google Drive.
- A code repository already indexed in [Graphify](https://app.graphify.com).
- A code repository already indexed in [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-policy-docs-next-to-code).
- A coding agent connected to the hosted MCP server. See [Connect cloud coding agents to hosted MCP](/cookbooks/cloud-coding-agents).

## Setup
Expand Down
2 changes: 1 addition & 1 deletion cookbooks/reuse-existing-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ A product team builds its web app mostly with coding agents. A designer notices

## Before you start

- A repository indexed in [Graphify](https://app.graphify.com).
- A repository indexed in [Graphify](https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=cookbooks-reuse-existing-code).
- A coding agent connected to the hosted MCP server. See [Connect cloud coding agents to hosted MCP](/cookbooks/cloud-coding-agents).

## Setup
Expand Down
8 changes: 4 additions & 4 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -306,7 +306,7 @@
"logo": {
"light": "https://graphify.com/assets/brand/graphify-logo-ink.svg",
"dark": "https://graphify.com/assets/brand/graphify-logo-white.svg",
"href": "https://graphify.com"
"href": "https://graphify.com?utm_source=docs&utm_medium=link&utm_campaign=nav"
},
"navbar": {
"links": [
Expand All @@ -318,7 +318,7 @@
"primary": {
"type": "button",
"label": "Start free",
"href": "https://app.graphify.com/signup"
"href": "https://app.graphify.com/signup?utm_source=docs&utm_medium=link&utm_campaign=nav"
}
},
"contextual": {
Expand Down Expand Up @@ -361,7 +361,7 @@
"items": [
{
"label": "Graphify",
"href": "https://app.graphify.com"
"href": "https://app.graphify.com?utm_source=docs&utm_medium=link&utm_campaign=nav"
},
{
"label": "Pricing",
Expand All @@ -373,7 +373,7 @@
},
{
"label": "graphify.com",
"href": "https://graphify.com"
"href": "https://graphify.com?utm_source=docs&utm_medium=link&utm_campaign=nav"
}
]
},
Expand Down
4 changes: 2 additions & 2 deletions for-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -162,8 +162,8 @@ Set up Graphify for me. Fetch https://docs.graphify.com/for-agents.md and follow
- 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.
- The [changelog](/changelog) on this site summarizes selected `graphifyy` releases. The current package version is on [PyPI](https://pypi.org/project/graphifyy/). The full history is on [graphify.com/changelog](https://graphify.com/changelog).
- The official site is [graphify.com](https://graphify.com). These docs are [docs.graphify.com](https://docs.graphify.com).
- The [changelog](/changelog) on this site summarizes selected `graphifyy` releases. The current package version is on [PyPI](https://pypi.org/project/graphifyy/). The full history is on [graphify.com/changelog](https://graphify.com/changelog?utm_source=docs&utm_medium=link&utm_campaign=for-agents).
- The official site is [graphify.com](https://graphify.com?utm_source=docs&utm_medium=link&utm_campaign=for-agents). These docs are [docs.graphify.com](https://docs.graphify.com).
- The local MCP server is the ten tools in the [MCP tool reference](/open-source/features/mcp-tools) and reads a graph on the machine. The hosted server is `https://api.graphify.com/mcp` (Streamable HTTP, OAuth, no API key). The [VS Code](/integrations/vscode), [JetBrains](/integrations/jetbrains), [ChatGPT, Codex, and Dots](/integrations/chatgpt), [OpenClaw](/integrations/openclaw), [Vercel](/integrations/vercel), and [Other agents](/integrations/other-agents) pages use the hosted server, not the ten-tool list. [Other local assistants](/integrations/other-agents) is the local skill for clients without their own page. [Codex](/integrations/codex) has a Graphify section and a Graphify CLI section.

To point an agent at these docs, give it this prompt:
Expand Down
Loading
Loading