# Koshi 0.3.0 — Changelog (/docs/v0.3/changelog) ## v0.3.0 [#v030] ### Remote sessions [#remote-sessions] * `koshi attach --remote ` 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 ` 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 [#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-` 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 [#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 [#v020] * 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 ` 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-.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 [#v010] * 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.