What problem does it solve?
Coding the same feature across a real codebase—especially when files must be explored, refactors are large, or PRs need review—often takes time and careful coordination that’s hard to do with simple one-shot edits.
Core Features & Use Cases
- Runs interactive coding agents via PTY: Spawn Codex, Pi, or OpenCode reliably using pseudo-terminal mode, so terminal UI flows work correctly.
- Focused workspace control: Provide a
workdir so the agent only “sees” the intended folder, reducing accidental browsing of unrelated files.
- Background sessions for long tasks: Start work asynchronously and monitor it with session actions (log/poll/write/submit/kill).
- Safe PR review workflow: Review pull requests from a temp clone or isolated git worktree instead of your live folder.
Quick Start
Start an agent for a longer refactor in a dedicated directory by running: bash pty:true workdir:~/project background:true command:"codex exec --full-auto 'Refactor the authentication module and add tests'".