wire / terminal-osc /
1
OSC 1 — Set icon name OSC 1 ; text ST sets the terminal's icon name (the short label used for the minimized/taskbar/tab representation), as distinct from the full window title. OSC 2 sets the title only; OSC 0 sets both icon name and title at once.
terminal-osc kind control-sequence status de-facto verification verified tier B terminal-escape@1
aka: set icon name · OSC 1 · ESC ] 1 · icon title
frame OSC introducer: \x1b] ESC ] (0x1B 0x5D)
terminator (ST|BEL ): ST \x1b\ · BEL \x07
parameters / subcommands id name bytes (ST) meaning set Set icon name \x1b]1;myapp\x1b\ OSC 1 ; Pt ST sets the icon name to the string Pt. Used for the minimized/taskbar/tab label, separate from the window title (OSC 2).
gotchas OSC 1 sets the ICON NAME only; OSC 2 sets the WINDOW TITLE only; OSC 0 sets BOTH. Pick the right number for what you want to change. Many modern terminals/tabs show only one string and treat icon name and title interchangeably, so OSC 1 may appear to do nothing visible. The string is plain text terminated by ST (or BEL); embedded control bytes are not allowed. There is no standard QUERY form for OSC 1 (unlike color OSCs); some terminals support OSC 21 to query the title-related strings. Restore or clear the title/icon on exit if you changed it, so the user's terminal label isn't left altered. provenance per-fact attribution:
agent: curl -H 'accept: application/json' wire.phall.io/terminal-osc/1⧉ copy
or /terminal-osc/1.json ⧉ copy
wire.phall.io ⌘K search main ✓