ralph-loop

To run interactive coding agents without hanging, you need TTY-safe execution that launches CLIs via exec with background process monitoring. This approach provides a real terminal environment, preventing sessions from freezing while polling for completion markers.

A TTY-safe loop is an orchestration mechanism that manages interactive CLI sessions using pseudo-terminals. It ensures coding agents like Goose or OpenCode execute reliably in the background, allowing you to poll logs and detect completion sentinels.

Yes, automating software building requires workflow files such as PROMPT.md, AGENTS.md, and IMPLEMENTATION_PLAN.md. These files separate the planning and building phases, allowing the agent to iterate through implementation and testing systematically.

Yes, you can monitor progress and stop background coding agent sessions on demand. The orchestration loop supports polling running sessions, reading logs, detecting completion markers, and issuing stop or kill commands when the task is finished or needs intervention.

Orchestrating interactive CLI agents requires an environment with exec and process tool support, along with pty-enabled terminal sessions. This setup is necessary to launch real terminal environments that prevent interactive coding agents from hanging.

Your coding agent hangs because it requires a real TTY terminal session but is launched without proper pseudo-terminal allocation. Using TTY-safe execution with process monitoring ensures the agent receives the terminal environment it needs to run interactively.