← Wednesday, October 7, 2026AgentsDeep dive

OSC 7501 lets programs report status and wait states to terminals

mitchellh.com 6 min read Editor score 8/10

The proposed terminal protocol lets programs report states such as working, blocked on user input, finished or failed, with an optional message; the post discusses why existing approaches fall short for coding agents. A shared status channel could help terminals and agent tools surface actionable waits consistently.

What
OSC 7501 is a terminal escape-sequence protocol for programs to report idle, working, waiting, finished, or failed status and why.
How
Programs can send state and context such as an app name and message; terminals or other tools can present it as notifications, inboxes, or status icons.
Why it matters
A generic terminal-native status signal helps users track long-running work and agent requests without relying on screen-reading heuristics.
OSC 7501 show status program terminal notification
Programs send OSC 7501 status to a terminal, which can present it to the user. Sketched from the article's own text.

Discussion

Discussion is not switched on yet. Use Note above to keep your own thoughts on this story.

Headline, summary, brief and diagram are written by a model from the source's own text; the link, byline and numbers come from the source. Read the original before relying on a claim.

Your note

Private to you. Stored in this browser, and synced to your account when you are signed in.