Arrange with AI agents
Once your pull request is open, ask your coding agent to arrange it. The agent reads the change, orders the files so each comes after what it depends on, groups them into sections with notes and checklists, saves the order, and gives you the link.
Arrange PR #123 in LogiKFlow in logical order.LogiKFlow is a remote MCP server, so it works with any agent that supports remote MCP servers with OAuth.
Connect
The server URL is:
https://logikflow.yemzikk.in/mcpClaude Code
claude mcp add --transport http logikflow https://logikflow.yemzikk.in/mcpThen run /mcp in Claude Code, select logikflow, and choose Authenticate. Add --scope user to the command to make it available in every project, not just the current one.
Cursor
Add to ~/.cursor/mcp.json, or .cursor/mcp.json in a project:
{
"mcpServers": {
"logikflow": { "url": "https://logikflow.yemzikk.in/mcp" }
}
}VS Code
Add to .vscode/mcp.json:
{
"servers": {
"logikflow": { "type": "http", "url": "https://logikflow.yemzikk.in/mcp" }
}
}Other clients
Add a remote server that uses the streamable HTTP transport, with the URL above. The client registers itself automatically.
Signing in
The first time, your browser opens a LogiKFlow page asking whether the app may act for you. It shows which app is asking and where access is sent. Choose Allow, then sign in with GitHub. For private repositories, the LogiKFlow GitHub App must be installed on the owning account or organization; see Quickstart.
Ask
Run the agent from the repository's checkout. It can then read the whole codebase, not just the diff, and the order is much better.
Arrange PR #123 in LogiKFlow in logical order.Create a LogiKFlow review for https://github.com/acme/app/pull/123 and add review checklists.Arrange the open PR for this branch in LogiKFlow.I pushed new commits to PR #123. Re-arrange it in LogiKFlow and keep the existing sections where they still fit.Say what you care about and the agent takes it into account, for example "put the migration first" or "keep the tests at the end".
What the agent does
- Reads the ordering guide with
get_ordering_guide. - Fetches the changed files and any saved order with
get_pull_request. - Studies the change, locally if it can, or from the patches.
- Saves the order with
save_reading_order. - Replies with the review link.
The MCP reference documents each tool.
Safety
- The agent acts as you. It reads only what your GitHub account can read, and saves only on repositories where you have write access.
- It can't drop or invent files. Every changed file must appear exactly once, or nothing is saved and the agent gets the list to fix.
- It can't silently overwrite. If someone saved a new order in the meantime, the agent gets a conflict and asks you.
- It's labelled. Orders saved by an agent say arranged by octo's AI agent on the page and in History, and any earlier version can be restored.
- You can disconnect. Remove the server from your agent.
Troubleshooting
| Message | What to do |
|---|---|
| GitHub access for this connection has expired | Reconnect: in Claude Code, /mcp, then Authenticate. |
| This pull request doesn't exist or this account can't see it | Check the owner, repo and number. For a private repository, install the GitHub App on the owning account. |
| doesn't have write access | Only people who can push to the repository can save an order. |
| The order must list every changed file exactly once | The agent will usually fix this itself. If it doesn't, ask it to call get_pull_request again and include every file. |
| Conflict | Someone saved a newer order. Ask the agent to fetch it and decide whether to replace it. |
| Rate limited | Wait a minute. The limit is 120 requests per minute per person. |