1 Upgrading to v0.8.3
Gaurav Gosain edited this page 2026-10-01 09:25:58 +04:00

tuios v0.8.3 gives every pane herdr's variables, changes the scratch terminal's keys, and saves pane history to disk. Some new features need a v0.8.3 daemon. This page lists each change and what to do.

The full release notes are at tuios.dev/releases/v0-8-3.

herdr

  • Every pane now gets HERDR_ENV, HERDR_SOCKET_PATH, HERDR_PANE_ID, HERDR_WORKSPACE_ID and HERDR_BIN_PATH. [agents] herdr_protocol now defaults to always.

  • With this default, herdr refuses to start inside a tuios pane. To run herdr in a tuios pane, set this in config.toml:

    [agents]
    herdr_protocol = "agents"
    
  • HERDR_PANE_ID now has herdr's form, w<session>:p<window>. A report with the window id still works.

Scratch terminal

  • Esc no longer hides the scratch terminal. Press Ctrl+B g to hide it.
  • The close key closes a pane of the scratch terminal. When you close the last pane, the scratch terminal ends.
  • The window keys act inside the scratch terminal. Before, a move, resize or tile key hid it.

Pane history

  • The daemon now saves the history of each pane in the state folder. The files hold what your panes printed, secrets included. To stop this, set persist_scrollback = false in [daemon]. The next daemon start deletes the saved history.

Mixed versions

  • Scratch layouts, pane history, image paste, tuios pip and the herdr socket API need a v0.8.3 daemon. To start a v0.8.3 daemon, run tuios kill-server after the upgrade. This closes every pane in every session, so save your work first.
  • While a client of an older tuios is attached, the scratch terminal is one pane in a popup, as in v0.8.2.