PR Studio

Connect a coding agent

Connect Codex or Claude Code to PR Studio so your agent can add before and after evidence to Cases. You review the comparison in PR Studio before the agent publishes it.

On macOS 14 or later, use PR Studio with Codex or Claude Code on the same Mac.

1. Choose a shared folder

In PR Studio, click Connect an Agent on Home or open Settings → Coding Agents. Click Choose Folder… and choose a local folder your agent can access. PR Studio remembers this folder and keeps its Cases data inside it.

2. Connect your agent

In PR Studio, click Copy Setup Prompt and paste it into a local Codex or Claude Code session on this Mac. The prompt tells your agent which shared folder to use. It can reuse the helper you selected in PR Studio or install it with your approval.

When your agent finishes, go to Check the connection. To configure it yourself, follow the manual steps below.

Download and choose the helper

Download MCP helper ZIP

The helper is signed and notarized for Apple silicon and Intel Macs.

  1. In Finder, open the downloaded ZIP to extract prstudio-mcp.
  2. Move the helper into a folder you plan to keep. For example, in Finder select Go → Home and create a folder called PR Studio MCP.
  3. Return to Coding Agents in PR Studio. Click Choose Helper… and select the extracted prstudio-mcp file. After registration, your coding agent starts the helper automatically.

Register the helper

Codex desktop

In the ChatGPT desktop app, open Settings → MCP servers → Add Server. Name the server prstudio and choose STDIO.

For Command, paste the full path displayed below Choose Helper… in PR Studio’s Install the helper step. Add two separate arguments in this order.

  1. --cases-directory
  2. The full folder path displayed in step 1 of Coding Agents.

Save, then select Restart. For Codex CLI, select Codex in step 3 of Coding Agents and copy its command. Run it in Terminal and start a fresh Codex session.

Claude Code

Select Claude Code in step 3 of Coding Agents and copy its command. Run it in Terminal to register the selected helper and Cases folder for all your projects.

Restart Claude Code and use /mcp to check that prstudio is connected.

3. Check the connection

Restart your client after saving its settings. In a fresh session, ask it to list PR Studio Cases with find_cases. A folder with no cases returns an empty list. Check the connection status at the top of Coding Agents in PR Studio.

For your first comparison, copy the task prompt under Teach your agent the routine and give it to your agent before it edits code.

For publishing approved Cases to GitHub, the agent also needs GitHub CLI 2.99 or later signed in to an account with access to the pull request.

Troubleshooting