Skip to content

First Session

After installing, start Claude Code. Zwischen attaches automatically — you don't need to do anything special.

What happens at session start

  1. The Zwischen daemon starts (if not already running) on localhost:8384.
  2. The SessionStart hook fires, contacts the Zwischen server, and opens a monitoring session for the reviewer.
  3. The reviewer begins watching the event stream.

You'll see a note in your session context confirming that Frank is attached, along with your session_id.

Try it out

Give Claude Code a task and watch the reviewer work in the background. The reviewer evaluates each tool call, file write, and stop attempt in real time. Most of the time it will silently pass — you'll only notice it when it intervenes.

To see what the reviewer is seeing and thinking:

/z spy

This shows the reviewer's transcript for the current turn — what was reviewed, what was passed, and any determinations that were made.

If you get blocked

When the reviewer blocks the agent, the agent will see the block reason and can dispute it using the message_adversary MCP tool. The agent sends a message directly into the reviewer's monitoring session, and the reviewer decides whether to lift the block.

You can also interact with the reviewer yourself:

/z ask How's the session going?

/z direct Let the agent proceed with file writes.

See Blocks and Disputes for the full enforcement model.

Adjusting scrutiny

The reviewer's scrutiny level (1–5) controls how aggressively it intervenes. To change it mid-session:

/z level 3

Higher levels mean more interventions. The default is set by the server profile.

Next steps