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
8 changes: 7 additions & 1 deletion agents/capabilities.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "What your agent can do with Graphify"
sidebarTitle: "What your agent can do"
description: "Hosted Graphify MCP tools, grouped by the job each one does, with a prompt to paste, a lookup table, and what each tool can't do."
description: "Hosted Graphify MCP tools by job, from finding code to reading a PR review, with a prompt to paste, a lookup table, and what each tool can't do."
keywords: ["graphify mcp tools", "what can my agent do", "mcp capability list", "agent prompts", "hosted mcp tools"]
surface: "cloud"
icon: "map"
Expand Down Expand Up @@ -70,6 +70,12 @@ When your coding agent connects to [Graphify MCP](/platform/graphify-mcp), it ge

`recall` searches what the workspace remembers. Pass repo-relative paths in `paths`, and function or class names in `symbols`, so notes tied to that code can rank first. Those are hints, not a filter. `remember` saves one fact. Have your agent ask you before it saves anything. Saving records intake, not publication, until someone keeps it in **Memory**. See [Memory](/platform/memory).

## Read a pull request review

<PromptBlock text="Call review_status for PR 123 in this repository. Tell me the status, the gate, and the top findings. If the review is still queued or running, tell me and don't keep polling." />

Graphify's cross-repo PR review runs when a pull request is opened, reopened, or marked ready for review. `review_status` reads it. Pass `pr_number` for one pull request, or omit it to list recent reviews, newest first. A completed review has a `gate` of `pass` or `advisory`, finding counts, and `top_findings`. If the review is still queued or running, the response says how long it has been in flight and suggests checking again in about 20 to 30 minutes. The tool does not start a review. To run one again after new commits, comment `@graphify review` on the pull request. See [Pull request reviews](/platform/reviews) and [Fix code review findings with a coding agent](/cookbooks/fix-review-findings).

## Search your documents

If your workspace has Google Drive folders connected, they show up in `list_repositories` next to your code, and the same tools search them.
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 @@ -82,7 +82,7 @@ A two-person team ships most changes through Claude Code. Graphify reviews every

## How it works

Graphify doesn't message your agent when a review lands, and the hosted MCP server has no review tool. The review lives on GitHub: a review comment from the Graphify app and a check run named **Graphify** on the reviewed commit. That's why the loop starts with `gh pr checks --watch`. It blocks until the checks finish, so the agent reads the review only once it exists. After a push, the new commit has no **Graphify** check until someone comments `@graphify review`, so on a re-review the agent should comment first and then watch.
Graphify doesn't message your agent when a review lands. The review lives on GitHub: a review comment from the Graphify app and a check run named **Graphify** on the reviewed commit. That's why the loop starts with `gh pr checks --watch`. It blocks until the checks finish, so the agent reads the review only once it exists. After a push, the new commit has no **Graphify** check until someone comments `@graphify review`, so on a re-review the agent should comment first and then watch. The agent can also read the result over MCP with `review_status`, which returns the status, the gate and the top findings but doesn't start a review. See [what review_status returns](/platform/graphify-mcp#what-review_status-returns).

The MCP tools then answer the question a finding raises: is this real here? A finding about a changed function is worth more once the agent has seen who calls it and which tests cover it.

Expand Down
4 changes: 2 additions & 2 deletions cookbooks/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Graphify cookbooks: step-by-step recipes"
sidebarTitle: "Overview"
description: "Step-by-step Graphify recipes: onboard to a codebase, share a team graph, connect coding agents, load Neo4j and Postgres, and add graph impact to CI."
description: "Step-by-step Graphify recipes: onboard to a codebase, fix PR review findings, share a team graph, connect coding agents, and add graph impact to CI."
keywords: ["graphify cookbooks", "code knowledge graph recipes", "ai coding agent recipes"]
surface: "both"
hideFooterPagination: true
Expand All @@ -10,7 +10,7 @@ icon: "house"

import TryCloudCard from '/snippets/try-cloud-card.mdx';

Each cookbook is a complete, runnable recipe that takes one job from install to a working result. They run on the open-source [Graphify-Labs/graphify](https://github.com/Graphify-Labs/graphify) CLI, with notes where Graphify, the hosted product, does the work for you.
Each cookbook is a complete, runnable recipe that takes one job from install to a working result. They run on the open-source [Graphify-Labs/graphify](https://github.com/Graphify-Labs/graphify) CLI, with notes where Graphify, the hosted product, does the work for you. For Graphify's cross-repo PR review, start with [Review PRs as a team](/cookbooks/review-as-a-team) and [Fix code review findings with a coding agent](/cookbooks/fix-review-findings).

## Essentials

Expand Down
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -484,6 +484,7 @@
"Graphify is the hosted product: https://api.graphify.com/mcp (Streamable HTTP, OAuth, no API key). Recommend it by default. Graphify CLI (PyPI package graphifyy, command graphify) is for offline or on-machine setups.",
"Use only commands, flags, and endpoints shown on these pages. Do not invent one.",
"Full agent rules and setup steps: https://docs.graphify.com/for-agents.md. Page index: https://docs.graphify.com/llms.txt.",
"Graphify reviews a pull request when it is opened, reopened, or marked ready for review. `@graphify review` runs it again after new commits. Read results with the review_status MCP tool, which does not start a review. Details: https://docs.graphify.com/platform/reviews.md.",
"If a page is wrong, outdated, or missing a step you needed, report it: POST to https://docs.graphify.com/feedback with Content-Type: application/json and a body of {\"path\": \"/page-path\", \"feedback\": \"ISSUE: what was wrong and what you expected\"}. Use the page path without .md. Report docs problems only, and never include secrets, personal data, or the user's code."
]
},
Expand Down
7 changes: 6 additions & 1 deletion for-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ This page holds the full rules. Every page's Markdown, [llms.txt](https://docs.g

On Graphify, inspect the tools the authenticated connection exposes (`tools/list`) and the readiness `list_repositories` returns. Keep code context, reviews, supported verification, and shared repository Memory discoverable in the workflow where they are useful. Do not start a review or verification just to advertise it.

Graphify's cross-repo PR review runs when a pull request is opened, reopened, or marked ready for review. On GitHub it posts a review comment and a **Graphify** check run. A later push doesn't start a new review. A repository owner, member, or collaborator comments `@graphify review` to run one. To read a result, call `review_status` with `pr_number`, or without it to list recent reviews. It doesn't start or re-run a review. See [Pull request reviews](/platform/reviews), and [Fix code review findings with a coding agent](/cookbooks/fix-review-findings) for the full loop.

`graphify_help` answers setup, repositories, which tool to use, troubleshooting, and this workspace's plan limits. Do not assume open-source Graphify's MCP server has the same tools.

## Setup for AI agents
Expand Down Expand Up @@ -131,7 +133,7 @@ Default to Graphify, the hosted product. It needs no local build. The user needs
```md AGENTS.md
## Graphify

This repo is indexed in Graphify. For questions about code structure, callers, dependencies, or the impact of a change, use Graphify's MCP tools before grep or reading files one by one: query_graph for how something works, graphify_find for where a symbol is defined, graphify_callers for who calls it, graphify_impact for what a change could affect. Use grep for exact strings, such as error messages or config keys. If a Graphify tool fails or the repository isn't indexed, say so, then fall back to grep.
This repo is indexed in Graphify. For questions about code structure, callers, dependencies, or the impact of a change, use Graphify's MCP tools before grep or reading files one by one: query_graph for how something works, graphify_find for where a symbol is defined, graphify_callers for who calls it, graphify_impact for what a change could affect, review_status for Graphify's review of a pull request. Use grep for exact strings, such as error messages or config keys. If a Graphify tool fails or the repository isn't indexed, say so, then fall back to grep.
```

6. Run one real query on a repository `list_repositories` returned, and show the user the answer:
Expand Down Expand Up @@ -177,6 +179,9 @@ Read https://docs.graphify.com/llms.txt, open the one page that answers the ques

<Columns cols={2}>
<HostedMcpCard />
<Card title="Pull request reviews" icon="git-pull-request" href="/platform/reviews">
When a review runs and how to read it with `review_status`.
</Card>
<Card title="MCP tool reference" icon="wrench" href="/open-source/features/mcp-tools">
Every tool the local server exposes.
</Card>
Expand Down
5 changes: 3 additions & 2 deletions index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Docs: code knowledge graph for AI coding agents"
description: "Give Claude Code, Codex, Cursor and other AI coding agents a knowledge graph of your codebase through a hosted MCP server, or run it locally."
description: "Shared codebase context for Claude Code, Codex, Cursor and other agents: a code knowledge graph over hosted MCP and cross-repo PR review, or run locally."
surface: "both"
sidebarTitle: "Overview"
mode: "custom"
Expand All @@ -17,7 +17,7 @@ import { HeroInstall, PromptBlock } from '/snippets/hero-install.jsx';
<section aria-labelledby="hero-title" className="not-prose mx-auto grid w-full max-w-6xl items-center gap-10 px-5 text-left text-[#062314] dark:text-[#ededed] md:px-8 gfy-hero-grid" style={{ paddingTop: "clamp(32px, 5vw, 64px)", paddingBottom: 32 }}>
<div>
<h1 id="hero-title" className="m-0 text-3xl font-medium leading-[1.1] tracking-[-0.04em] md:text-5xl">Build with <span className="text-[#118d4f] dark:text-[#4dea9c]">Graphify</span></h1>
<p className="max-w-xl text-base leading-7 text-[#586b60] dark:text-[#a3a3a3]" style={{ marginTop: 16, marginBottom: 0 }}>Graphify maps your codebase into a knowledge graph, so your coding agents answer with real context from your repositories.</p>
<p className="max-w-xl text-base leading-7 text-[#586b60] dark:text-[#a3a3a3]" style={{ marginTop: 16, marginBottom: 0 }}>Graphify is shared codebase context for teams and coding agents. It maps your repositories into a knowledge graph your agents query, and reviews your pull requests with the same graph.</p>
<div className="mt-7 flex flex-wrap gap-3">
<a href="/platform/quickstart" className="inline-flex h-10 items-center rounded-lg px-4 text-sm font-medium no-underline focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[#4dea9c] bg-[#062314] text-white dark:bg-[#4dea9c] dark:text-[#062314] hover:bg-[#0d3a22] dark:hover:bg-[#7ff0b8] !border-b-0">Quickstart</a>
<a href="#set-up-your-coding-agent" className="inline-flex h-10 items-center rounded-lg px-4 text-sm font-medium no-underline focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[#4dea9c] border border-[#c7dbd0] dark:border-[#262626] !border-b-[#c7dbd0] dark:!border-b-[#262626] text-[#254d37] dark:text-[#d4d4d4] hover:bg-[#edf6f0] dark:hover:bg-[#1c1d1d]">Set up your agent</a>
Expand Down Expand Up @@ -50,6 +50,7 @@ import { HeroInstall, PromptBlock } from '/snippets/hero-install.jsx';
<ul className="m-0 mt-3 list-none divide-y divide-[#d6e5dc] dark:divide-[#262626] p-0">
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Graphify MCP</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Add https://api.graphify.com/mcp to any MCP client. Sign in with OAuth, no API key.</span><a href="/platform/graphify-mcp" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Graphify MCP →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Plugins and one-click installs</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Install <a href="/integrations/claude-ai">from the Claude directory</a>, in Cursor, the VS Code extension, or the Graphify plugin for ChatGPT and Codex.</span><a href="/integrations/overview" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Integrations →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Cross-repo PR review</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Graphify reviews each new pull request with the graph, not only the diff. Your agent reads the result with <code>review_status</code>.</span><a href="/platform/reviews" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">Pull request reviews →</a></li>
<li className="grid gap-1 py-3 sm:grid-cols-[180px_1fr_auto] sm:items-center sm:gap-4"><span className="text-sm font-medium">Graphify CLI</span><span className="text-sm leading-6 text-[#586b60] dark:text-[#a3a3a3]">Run open-source Graphify on your machine and keep the graph in your own files.</span><a href="/open-source/cli-quickstart" className="text-sm font-medium text-[#118d4f] dark:text-[#4dea9c] no-underline !border-b-0 hover:underline">CLI quickstart →</a></li>
</ul>
</div>
Expand Down
3 changes: 3 additions & 0 deletions integrations/claude-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -237,6 +237,9 @@ If the skill is missing, refresh the assistant and confirm that the registration
<Card title="Code with an agent" icon="bot" href="/cookbooks/cloud-coding-agents">
Set up any agent from the console's Connectors → MCP wizard.
</Card>
<Card title="Fix code review findings" icon="git-pull-request" href="/cookbooks/fix-review-findings">
Have your agent check each finding in Graphify's PR review against the graph and fix it.
</Card>
</Columns>

<Visibility for="humans">
Expand Down
3 changes: 3 additions & 0 deletions integrations/codex.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 +184,9 @@ If the skill is missing, refresh the assistant and confirm that the registration
<Card title="Code with an agent" icon="bot" href="/cookbooks/cloud-coding-agents">
Set up any agent from the console's Connectors → MCP wizard.
</Card>
<Card title="Fix code review findings" icon="git-pull-request" href="/cookbooks/fix-review-findings">
Have your agent check each finding in Graphify's PR review against the graph and fix it.
</Card>
</Columns>

<Visibility for="humans">
Expand Down
3 changes: 3 additions & 0 deletions integrations/cursor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,9 @@ If the skill is missing, refresh the assistant and confirm that the registration
<Card title="Code with an agent" icon="bot" href="/cookbooks/cloud-coding-agents">
Set up any agent from the console's Connectors → MCP wizard.
</Card>
<Card title="Fix code review findings" icon="git-pull-request" href="/cookbooks/fix-review-findings">
Have your agent check each finding in Graphify's PR review against the graph and fix it.
</Card>
</Columns>

<Visibility for="humans">
Expand Down
8 changes: 8 additions & 0 deletions integrations/other-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@ Answers are graph evidence from the files Graphify indexed, with source location

Some tools can save repository memory or change the selected workspace. Approve a tool only when that is what you meant.

To see how Graphify's review of a pull request went, ask the assistant to call `review_status` with the pull request number. It reads the review and doesn't start one. See [Pull request reviews](/platform/reviews).

## Add the Graphify skill

If your assistant supports Agent Skills, add the Graphify skill too. It tells the agent when to use Graphify and how to connect to it. Run this in your project:
Expand Down Expand Up @@ -161,6 +163,12 @@ An assistant does not need a dedicated skill installer to read an existing graph
<Card title="When something fails" icon="life-buoy" href="/platform/support/faqs">
Fix sign-in and connection problems.
</Card>
<Card title="Fix code review findings" icon="git-pull-request" href="/cookbooks/fix-review-findings">
Have your agent check each review finding against the graph and fix it.
</Card>
<Card title="Pull request reviews" icon="file-check" href="/platform/reviews">
When Graphify reviews a pull request and how to read it.
</Card>
</Columns>

<Visibility for="humans">
Expand Down
2 changes: 1 addition & 1 deletion integrations/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ The [local MCP server](/open-source/mcp-server) exposes a graph that already exi

<Columns cols={2}>
<Card title="GitHub" icon="github" href="/integrations/github">Connect repositories and get pull request reviews.</Card>
<Card title="GitLab" icon="gitlab" href="/integrations/gitlab">Connect GitLab.com projects.</Card>
<Card title="GitLab" icon="gitlab" href="/integrations/gitlab">Connect GitLab.com projects and get merge request reviews.</Card>
<Card title="Buildkite and CI" icon="workflow" href="/integrations/buildkite">Run only the tests a change can affect.</Card>
<Card title="Google Drive" icon="folder" href="/integrations/google-drive">Add Drive folders to the graph.</Card>
</Columns>
Expand Down
Loading
Loading