peach agent

Receive inspect messages from the active Peach simulator with any coding agent. listen drains one pending message or waits for the next one, saves full describe, inspect JSON, and screenshot evidence under the OS temporary directory, then exits. info prints the complete saved bundle. The remaining commands manage Peach-hosted Codex and Claude sessions.

terminal

peach agent attach <dir> [--name <label>] [--provider codex|claude]
peach agent projects
peach agent project show <id>
peach agent project remove <id>
peach agent sessions [--project <id>] [--all]
peach agent start <projectId> [--provider codex|claude]
peach agent prompt <sessionId> "<text>"
peach agent watch <sessionId>
peach agent listen [--sim <id>]
peach agent info <message-id>
peach agent transcript <sessionId>
peach agent end <sessionId>
peach agent paths

Options

flag	description
`--name <label>`	human-readable label when attaching a project
`--provider <id>`	agent backend: codex (default) or claude; used by attach + start
`--project <id>`	filter sessions to a specific attached project
`--all`	include ended sessions (sessions defaults to active only)
`--sim <id>`	listen for inspect messages from a specific sim

Examples

terminal

peach agent attach ~/projects/three-punch --name 3pc
peach agent projects
peach agent project show 3pc
peach agent start 3pc --provider claude
peach agent prompt <sessionId> "fix the failing scroll test"
peach agent watch <sessionId>
peach agent listen
peach agent info <message-id>
peach agent sessions --all
peach agent transcript <sessionId>
peach agent end <sessionId>
peach agent paths

claim

peach agent

#Options

#Examples

#Related

Options

Examples

Related