Skip to content

Spy Transcript

The spy transcript (/z spy) shows you what the reviewer saw and did during your session. It's the primary way to understand the reviewer's decision-making process.

Viewing the transcript

/z spy

This shows the transcript for the most recent user turn. Each turn starts when you send a message and ends when the agent finishes its response.

To view a specific turn:

/z spy 3

What the transcript shows

The transcript includes:

  • Tool calls the agent made and whether they were passed or blocked
  • Review determinations — the reviewer's pass/block decision for each event, with reasoning
  • Direct messages — any message_adversary exchanges between the agent and the reviewer
  • User interactions/z ask and /z direct messages and the reviewer's responses
  • Stop evaluations — whether the reviewer approved or blocked the agent's stop attempt

Reading the transcript

Events appear in chronological order within each turn. For each reviewed event, you'll see:

  1. The event type and details (tool name, input summary)
  2. The reviewer's determination (pass, block, or release)
  3. The reviewer's reasoning

Blocked events are clearly marked with the block reason. Released blocks show the dispute exchange that led to the release.

When to use spy

  • After a block — understand why the reviewer intervened
  • After a long session — review what the agent did and whether the reviewer caught anything
  • Debugging configuration — verify that the right tools are being reviewed at the right tier
  • Evaluating the reviewer — see if the reviewer is being too aggressive or too permissive, and adjust scrutiny or configuration accordingly