Glossary¶
Agent – The AI coding assistant (Claude Code) doing the actual work in your session. Zwischen monitors the agent's actions.
Block – An enforcement decision by the reviewer that stops the agent from proceeding. Three types: tool block (denies a tool call), write block (rejects a file change), stop block (forces the agent to continue working).
Context cycling – Automatic reset of the reviewer's context window when it approaches capacity. The reviewer writes a handoff summary, and a new session starts with that summary plus recent events.
Daemon – The local HTTP server (localhost:8384) that runs on your machine during a Claude Code session. Manages communication between the hooks, the MCP server, and the Zwischen server.
Determination – The reviewer's decision for a given event: pass, block, or release.
Frank – The reviewer. Named after zwischenzug – the chess "in-between move."
Handoff summary – A compressed account written by the reviewer during context cycling, summarizing what it's seen and any ongoing concerns. Carried into the fresh context.
Hook – A Claude Code hook that fires on specific events (SessionStart, PreToolUse, Stop, etc.). Zwischen installs hooks for all eight Claude Code hook events.
MCP server – The local MCP (Model Context Protocol) server that provides the message_adversary tool to the agent. Runs as a separate process spawned by Claude Code.
Monitoring session – The reviewer's AI conversation with the Zwischen server. Each agent (main or subagent) gets its own independent monitoring session.
Orchestrator – The default name for the main Claude Code agent. Used for profile matching when no custom agent name is set.
Pre-review – Review that happens before a tool executes. The reviewer can block the tool call before it runs.
Profile – A named configuration block in settings.yaml that applies specific reviewer settings to specific agents.
Release – An enforcement decision that lifts a previous block. Issued when the reviewer agrees to let the agent proceed after a dispute.
Reviewer – The second AI model that watches the agent's event stream and issues enforcement decisions. See Frank.
Scrutiny level – A 1–5 scale controlling how aggressively the reviewer intervenes. Higher levels mean more blocks.
Session ID – A unique identifier for a Claude Code session. Groups all agents (main and subagents) in one user task.
Spy transcript – The reviewer's activity log, viewable via /z spy. Shows reviewed events, determinations, and reasoning.
Subagent – An agent spawned by the main Claude Code agent (via the Agent tool). Each subagent gets its own independent reviewer session.
Write review – A specialized form of pre-review for Edit and Write tools. The reviewer sees the proposed file diff and can reject it before the file is modified.
Zwischenzug – A chess term for an "in-between move" – an unexpected intermediate move that disrupts the opponent's expected line. The inspiration for the product name.