osc sequences are how a program tells the terminal something other than text: its title, its folder, a link, a status. this is what resesh understands and what it does with each one.
a sequence starts with esc ] and ends with bel or esc \. the last column says what changes in a persistent session kept alive by tmux, which sits between the program and resesh. with the resesh agent nothing in this table changes, and links, prompt marks and program status come back after a reconnect.
| osc | name | what resesh does | with tmux persistence |
|---|---|---|---|
| titles and folders | |||
| 0, 1, 2 | window and icon title | sets the tab subtitle. agents are also recognised from their titles. | tmux sends the title of the active pane. |
| 7 | current folder | file://host/path. the file pane follows it, and command history records it. | the folder is read from tmux instead. |
| 9;9 | current folder, windows form | the conemu form that powershell and cmd prompts use. treated like osc 7. | |
| 1337;CurrentDir | current folder, iterm2 form | treated like osc 7. other osc 1337 keys are ignored. | |
| commands | |||
| 133 | prompt and command marks | a, b, c and d marks give exact command boundaries and exit codes for the ruler, the command list, command history and the finished-command bell. | works for shells started with resesh shell integration. |
| 3008 | systemd context | start and end records from systemd 257 and newer supply the host, user, folder and exit result when the shell sends no osc 133. | |
| links and clipboard | |||
| 8 | hyperlinks | click to open in your browser. the real target shows on hover. | needs tmux 3.4 or newer. |
| 52 | clipboard write | a remote program copies text to the windows clipboard. reading is refused, so a host can never see your clipboard, and playback never touches it. | passes through. |
| status and notifications | |||
| 7501 | program status | idle, working, blocked, done and error, with an app name, a message and a percentage. shown as the tab badge and progress bar. the support probe (7501;?) is answered. | dropped by tmux. the codex, claude code and shell-wrapper adapters report through a tmux option instead. |
| 9;4 | progress | normal, error, paused and indeterminate progress on the tab and the taskbar button. cleared when the command ends. | |
| 9 | notification | marks the tab with a grey attention badge. no windows notification is raised. | dropped by tmux. |
| 777;notify | notification, rxvt form | the same grey badge. the reserved title resesh-agent carries agent state from the claude code adapter. | dropped by tmux. |
| 7377 | resesh agent events | resesh's own form: agent;id=…;state=…;label=…. used by the adapter snippets in settings › agents. | dropped by tmux. |
| colours and pointer | |||
| 4, 104 | palette colours | set, query and reset any of the 256 palette colours. | |
| 10, 11, 12 | foreground, background, cursor | set and query. programs use the query to tell a light theme from a dark one. | |
| 110, 111, 112 | reset colours | return the foreground, background and cursor to the theme's colours. | |
| 21 | kitty colour protocol | set, query and reset the same colours by name. | |
| 22 | pointer shape | the mouse pointer takes the shape a program asks for. a link under the pointer still shows the hand. | not forwarded by tmux. |
an osc that resesh does not know is ignored and never printed. the same holds in rewind and recording playback, which also never write to the clipboard.
each line works in bash on a remote host or in a local tab.
sequences you might expect that resesh ignores today.
free and open source. x64 and arm64 installers, or a portable zip. windows 10 21h2 or newer.