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 withgh 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: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:@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 reviewcomment. - 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 reviewdid nothing. The comment has to come from an owner, member or collaborator.- The agent can’t find the repository. Call
list_repositoriesand 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.