Skip to main content
Graphify reviews a pull request and leaves findings. Someone still has to read them, decide which are real, and fix them. A coding agent can do most of that work, as long as it knows when the review is ready, checks each finding against the code before changing anything, and asks for a new review when it’s done. This recipe sets up that loop.
Works with: Graphify (hosted), with Claude Code, Codex or any agent that can run the GitHub CLI.

The short version

Already connected? Paste this into your agent: The rest of this page sets it up so it happens every time.

The scenario

A two-person team ships most changes through Claude Code. Graphify reviews every pull request, and the findings are useful, but they pile up while both people are busy. They want the agent that opened the pull request to pick up the review, fix what’s real, explain what it skipped, and get a fresh review, without anyone copying findings into a chat.

What you’ll build

  • A short instruction block that tells the agent how to run the loop.
  • A loop the agent runs on a pull request: wait for the review, read the findings, check each one with Graphify’s MCP tools, fix, push, and ask for a fresh review.
  • A habit of teaching Graphify which findings were wrong, so later reviews get quieter.

Before you start

  • A repository indexed in Graphify with PR reviews on. See Pull request reviews.
  • A coding agent connected to the hosted MCP server. See Connect cloud coding agents to hosted MCP.
  • 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.

Setup

1

Add the loop to the agent's instructions

Add this to CLAUDE.md or AGENTS.md and commit it. Replace acme/web-app with the repository’s name in Graphify.
AGENTS.md
2

Open a pull request

Open a pull request as usual. Graphify reviews it when it’s opened, reopened or marked ready for review. Drafts are skipped until they’re marked ready.
3

Hand the review to the agent

In the agent session, ask:
The agent waits for the Graphify check run, reads the review, and works through the findings.

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. 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.

Review again

A push doesn’t start a new review. When the fixes are in, comment on the pull request:
Graphify reviews the current head as a fresh pass over the diff. The new review doesn’t list which earlier findings were fixed, so the agent’s list from step 5 is your record of what changed and what was skipped.

Teach Graphify what was wrong

When the agent decides a finding doesn’t apply, and you agree, reply on the pull request with the finding’s exact name:
Use @graphify good <finding> for findings that were right, and @graphify suppress <rule> to mute a rule. The Learn view shows what Graphify has learned. Learning changes which advisory findings show up. It never changes formal verification results.

Verify it worked

  • The pull request has a Graphify check run on the latest commit, from after your @graphify review comment.
  • The agent’s summary names each finding as fixed or skipped, with a reason.
  • Reviews in Graphify shows the new run for the pull request.

Troubleshooting

  • No Graphify review on the pull request. Check that PR reviews is on for the repository, and that the pull request isn’t a draft.
  • @graphify review did nothing. The comment has to come from an owner, member or collaborator.
  • The agent can’t find the repository. Call list_repositories and use the exact name it returns.

Next steps

Try it in Graphify

We build and host the graph for you. The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.

Pull request reviews

When reviews run and how to read them.

Learning

Tune which findings Graphify raises.