Changelog

v0.3.0

Remote sessions

• koshi attach --remote <server> attaches this terminal to a session on another machine, over TLS.
• The first connection to a machine records the certificate it presents and pins it; a later connection presenting a different certificate is refused and names both fingerprints.
• remote-listen in koshi.kdl names the address the remote listener binds. Writing that line opens no port: the port opens the first time koshi share grant runs and you answer yes to the offer, and on every start after that.
• koshi share grant, koshi share revoke, and koshi share list hand out, stop, and list the access tokens that reach the sessions on this machine. A grant reaches every session or one named session, prints its token once, and stops working after 24h unless --expires says otherwise.
• koshi remote new, edit, list, forget, and set-secret keep the servers this machine dials. new and edit ask for the name, the address, and the secret in turn, then dial the server to check the secret before saving.
• A secret never appears on a command line: koshi reads KOSHI_REMOTE_SECRET, and with that unset asks for it at the terminal without printing what is typed.
• koshi list-sessions also lists the sessions of every saved server that answers, each row naming its server in a new server column; --remote <server> lists that one server's sessions.
• Bare koshi attach offers the sessions on the saved servers beside this machine's own, and asks which one to attach to whenever a session on a server is listed.
• remote-reconnect dials a dropped remote link again — after 1, 2, 4, 8 seconds, and 8 before every dial after that, for up to 120 seconds — while the tab strip counts down to the next dial. Joining again restores the active tab, each tab's focused and fullscreened pane, and each pane's scroll position.
• A remote refusal no dial can change stops the dialing at once and names itself: a certificate that is not the pinned one, a token the server does not admit, a token that does not reach the session, or two builds sharing no protocol version.
• koshi share verbs run inside a koshi pane are refused while anyone is attached to that pane's session from another machine, so a token never prints onto a screen someone else reads.

Sharing this machine

• allow-other-users lets the other users of this machine list, attach to, and kill your sessions, and shared-sessions-dir names where those session sockets live. koshi --headless --allow-other-users opens one session that way for its whole life.
• Sessions are advertised in /tmp/koshi-<your user id> on Linux and macOS, named after your user id alone, so every shell finds the same sessions. KOSHI_RUNTIME_DIR names another directory when it holds an absolute path.

Updating and checking

• koshi update restarts the running koshi servers into the new release: each session replaces its own program while keeping its panes, the programs in them, and their scrollback, and the process that tracks sessions restarts after them. A session that refuses the restart is named on standard error and keeps the old build.
• koshi server-version prints the build every running koshi server runs, one row per server, so a session still on the old build shows beside the ones that moved.
• koshi doctor checks this machine's installation — config, shell, terminal, runtime directory, log directory, plugins directory, router, session directory, remote access, and remote connections — and rates each row ok, warn, or fail.

v0.2.0

• Sessions run in their own process and keep running after the terminal leaves.
• koshi attach joins a running session; without a name it lists the running ones to pick from.
• koshi detach leaves a session without ending it; --all detaches every terminal of one session.
• koshi --headless starts a session with no terminal attached and prints its id.
• koshi attach <session> typed inside a pane moves that terminal to another session.
• Several terminals can view one session at once, each with its own focus and view.
• A terminal that missed an event resyncs instead of drawing a stale view.
• The quit shortcut leaves the session running instead of ending it.
• auto-close-session ends a session once its last terminal leaves.
• Each terminal reads its own theme, keybindings, and view settings from its own files.
• Sessions and tabs accept their printed id anywhere their name is accepted, and an id is never re-read as a name.
• koshi debug dump-state and koshi debug dump-layout print running state and solved layouts.
• A panic writes crash-<timestamp>.txt to the data directory after restoring the terminal.
• Terminal reset and custom tab stops.
• A koshi that cannot speak another koshi's protocol version refuses and names both version ranges.
• The session server starts with no console window on Windows.
• Dragging a pane border moves it the whole drag distance in one step instead of one cell at a time.
• The shortcut hint bar updates without waiting for the next frame.
• A stop request that fails skips the wait and ends the process at once.
• allow-beta-features runs features still marked beta; this release marks none.
• Smaller cell storage, cheaper mouse movement, and lower scrollback memory.

v0.1.0

• Split, stacked, fullscreen, focus, resize, and close operations for panes.
• Tab creation, closing, movement, and switching.
• Per-pane processes, terminal screens, scrollback, and selections.
• True colour, text styles, alternate screens, wide characters, emoji, and box drawing.
• Mouse focus, border resizing, scrolling, text selection, and OSC 52 clipboard copy.
• Multi-key shortcuts, configurable leader keys, shortcut hints, and conflict checks.
• Locked input mode and mouse selection mode.
• KDL files for app settings, themes, keybindings, and saved layouts.
• Twenty-five ready-made themes.
• Saved profiles with tabs, pane layouts, commands, working directories, and environment values.
• Local config path, explanation, validation, and migration commands.
• Session, tab, pane, and client discovery commands.
• External pane, tab, input, focus, lock, and session control commands.
• Per-session text or JSON logging.
• Startup update checks, explicit self-update, and release installers.
• Linux, macOS, and Windows support on x86-64 and ARM64.
• Input aimed at an open shortcut stays in koshi until that shortcut completes or is cancelled.
• Pane input reaches only panes visible to the issuing client.
• New panes inherit the issuing terminal's working directory when no directory is given.
• Config files require an explicit schema version.
• Config migration validates the source and every version step before accepting output.