Agent workflows

Give a coding agent a narrow network question and evidence it can check.

Compact HUD shows Stopped, 25 sessions, zero approvals, and separate Start Proxy and Start MCP buttons.
Read status before asking the agent to investigate.Sessions remain visible with the proxy stopped. Check both controls before expecting a new request or a reply from a connected agent.Open full-size screenshot · Connect a coding agent

Your test app opens, but the catalog stays blank. Refresh it once and ask your coding agent: “Which request did the catalog make just now? Show me the host, path and status if you can see them. Leave the response body out for now.”

Find the catalog request

Connect your agent and route your test device through JoesProxy before you refresh. Give the agent the catalog host and the time you tapped Refresh. It can search captured sessions without putting the whole capture into chat. Check the match: an artwork request from the same host can fail without explaining the empty catalog.

Give the app one recognizable title

Once you know the endpoint, ask: “Propose a replacement response for this catalog request. Use our test catalog with one title named Proxy Test. Leave the artwork requests alone.”

Review the host and path on your Mac before approving the change. Use a test response your app already knows how to read. Permission to see a request’s status doesn’t give an agent permission to read its body or turn on a rewrite.

Refresh again. Ask the agent which rule matched the new request, then look at the screen. If Proxy Test appears, the app displayed your replacement. If JoesProxy shows the replacement but the screen is still blank, you’ve narrowed the next question: what did the app do with that response? If no rule matched, check the rewrite guide before changing the app.

If the agent can see the tool but can’t use it

Check which operation was denied: searching sessions, reading a body or changing traffic. Review that specific permission on the Mac; don’t grant access to the whole capture to get past one error. See permission troubleshooting. For a question like “How many titles came back?”, the agent can ask the Mac to count them locally instead of returning every item.

Remove the test catalog

Disable the rule and refresh once more. Check that the new request used the ordinary source and the test title is gone. Disconnect the client, review any grants you made for the test and restore the device’s previous proxy settings.

Local approvals panel shows a pending request to simulate an upstream 503 for a synthetic host, with allow and deny controls.
Inspect the pending proposal.Read the requested effect, host and client before deciding. No choice has been made in this capture; a pending proposal is not an executed rule.Open full-size screenshot · Check agent setup and permissions