sootsim agent

attached projects + local agent sessions (codex/claude)

sootsim agent

Manage attached project directories and the agent sessions running inside them. Session-lifecycle commands (start, prompt, watch, end) route through the bridge daemon, which owns the single FIFO reader per session so concurrent cli watches + electron UI subscribers no longer steal bytes from each other. Disk-only inspection commands (projects, sessions, paths, transcript) read attached-project state directly — no daemon needed.

terminal

sootsim agent attach <dir> [--name <label>] [--provider codex|claude]
sootsim agent projects
sootsim agent project show <id>
sootsim agent project remove <id>
sootsim agent sessions [--project <id>] [--all]
sootsim agent start <projectId> [--provider codex|claude]
sootsim agent prompt <sessionId> "<text>"
sootsim agent watch <sessionId>
sootsim agent transcript <sessionId>
sootsim agent end <sessionId>
sootsim 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)

Examples

terminal

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

claim

sootsim agent

sootsim agent

#Options

#Examples

#Related

Ready to build?

Options

Examples

Related