OSC 7501: a terminal protocol for program status

A terminal-native status protocol could replace brittle screen-reading heuristics and per-dashboard integrations with structured state emitted over the existing PTY.

Logged at IST: 2026-10-07 02:34 IST

What it is: Mitchell Hashimoto's proposal for OSC 7501, a terminal-native protocol that lets programs report states such as working, blocked, done, or error, with optional context.

Gist: Instead of dashboards inferring state from screen text/window titles or requiring each program to integrate with each dashboard's API, a program emits structured status over its existing PTY. The terminal decides how to present it. That makes the same mechanism applicable to agents, builds, package managers, and deployment tools, and naturally works through SSH and containers. The specification also defines state records, feature detection, limits, and security considerations.

Why it matters: The idea replaces a growing N-by-N integration and heuristic problem with a shared terminal protocol. The proposal is promising, but its usefulness depends on adoption by terminals and programs; the article reports prototypes, not broad ecosystem support.

Source read: https://mitchellh.com/writing/program-status-osc7501; https://www.superlogical.com/rex/docs/build/program-status