New terminal escape sequence OSC 7501 proposed to report program status
A specification has been published for OSC 7501, dubbed the Program Status Protocol, a terminal escape sequence that lets programs report states such as idle, working, waiting on user input, finished, or failed, along with a reason. The author gives an example of Terraform using the sequence to signal it is blocked awaiting a permission confirmation, with terminals free to display that status as a notification, icon, or inbox entry. The spec grew out of the author's work on Superlogical and Ghostty but is presented as a generic, product-agnostic standard any terminal could adopt.
GoKawiil's interpretation of the reporting above, not reported fact.
Long-running terminal tasks—builds, deployments, and increasingly AI coding agents—often leave users unsure when something needs their attention, and the author argues existing solutions like foreground-process monitoring or output-quiet detection are incomplete workarounds. A standardized status protocol could let terminal developers build consistent, richer notification features across different tools rather than each inventing its own heuristic. Adoption, however, depends on other terminal and program developers choosing to implement the spec, which is not guaranteed.
- OSC 7501 is a proposed terminal escape sequence for reporting program status like idle, working, blocked, or failed.
- It is designed to be generic and terminal-agnostic, not tied to any specific product, despite originating from Superlogical and Ghostty work.
- The author frames it as addressing gaps in existing notification methods, particularly for long-running tasks and coding agents.
Source: mitchellh.com, 2026-10-06
Published there as: “A Terminal Protocol for Program Status (OSC 7501)”
Read the original report → The summary and analysis above are GoKawiil's own, written from reporting by the source above. Facts and quotes belong to the original publisher.