claude-pee wraps claude CLI for interactive scripting

The GitHub repository "sbhattap/claude-pee" publishes a Rust-based wrapper intended as a drop-in front end for the claude CLI, per the project's README. The wrapper "spawns claude in a PTY", assigns a fresh --session-id <UUIDv4>, forwards all other flags verbatim, optionally injects a one-shot prompt via -p, tails the matching session transcript JSONL, and prints the assistant reply to stdout in text, json, or stream-json formats. The README documents that termination is driven by claude's Stop hook: the hook touches a sentinel file, claude-pee detects it, sends /exit, and exits with the child's status code. The repository lists Rust 1.85+ as a requirement and shows cargo build --release as the install step.

The wrapper relies on a pseudo-terminal (PTY) to emulate interactive terminal behavior and on explicit session identifiers (--session-id <UUIDv4>) to correlate transcript lines. Capturing session transcripts as JSONL and offering stream-json output are practical for automation, test harnesses, and reproducible logging in pipelines. The sentinel-file plus Stop-hook mechanism is a conservative approach to detect turn completion without using fragile idle heuristics.

Small, focused shims like this address a recurring developer need: invoking an assistant CLI from scripts and CI while preserving the interactive semantics and structured transcripts. For teams that consume assistant outputs programmatically, the combination of session IDs and JSONL tailing reduces manual parsing, and the multiple output formats allow either human-friendly text or machine-friendly JSON streams.

Watch compatibility with different claude CLI versions and how the wrapper handles thinking-only or tool-use-only turns (the README notes text output skips those). Observers should also consider operational hygiene: storing transcripts, handling sentinel files in ephemeral environments, and securing any persisted session data when integrating such wrappers into automation.