Koshi / terminal multiplexer

Koshi: Open-Source Terminal Multiplexer

Koshi is an open-source Rust terminal multiplexer for persistent terminal sessions. It keeps panes and programs running after a terminal disconnects, supports tabs and layouts, and lets each attached terminal keep its own view.

Persistent terminal sessions

A Koshi session runs in its own process. Closing a terminal, losing an SSH link, or leaving the session does not stop the programs inside its panes.

Attach again to restore the session. Several terminals can watch one session while keeping separate focus, tabs, scroll positions, themes, and keybindings.

koshi
koshi detach
koshi attach

Read how sessions work

Panes, tabs, and layouts

Panes hold individual processes, terminal screens, and scrollback. Tabs hold complete pane layouts. Split panes left, right, up, or down, then move through the layout with keyboard shortcuts or mouse input.

Saved profiles can restore tabs, panes, commands, directories, and environment values.

Learn about panesLearn about tabs

Per-client views

The session owns processes, panes, tabs, and scrollback. Each attached terminal owns its focus, active tab, fullscreen state, scroll position, selection, theme, and keybindings.

This lets several people attach to one session without moving each other’s screens.

Read about per-client views

Remote terminal sessions

Koshi can attach to a session on another machine over TLS. The remote server starts closed, access uses scoped tokens, and the client pins the server certificate on its first connection.

A dropped connection can reconnect and restore the client view.

Read about remote sessions

Terminal images

Programs in a pane can draw terminal images through Kitty, iTerm2, or Sixel. Koshi keeps each image at its cell placement through scrolling, resizing, and screen switches.

A terminal without image support receives a readable placeholder instead of losing the surrounding terminal content.

Read about terminal images

Supported systems

Koshi ships for Linux, macOS, and Windows on x86-64 and ARM64. It is free and open source under the MIT license.

Install KoshiOpen the source repository

Common questions

What is Koshi?

Koshi is an open-source Rust terminal multiplexer for persistent sessions, panes, tabs, remote access, and terminal images.

Does Koshi keep running after the terminal closes?

Yes. A Koshi session runs in its own process, so its panes and programs keep running after the attached terminal leaves.

Does Koshi run on Windows?

Yes. Koshi ships for Linux, macOS, and Windows on x86-64 and ARM64.