# Docs

- v0.1: koshi 0.1.0

  - **Start**
  - [Introduction](/docs/v0.1): koshi is a terminal multiplexer that runs panes and tabs inside one terminal window, with its own process, screen, and scrollback per pane.
  - [Installation](/docs/v0.1/installation): Install koshi on Linux, macOS, or Windows with Homebrew, Scoop, the release script, or from source.
  - [Quick start](/docs/v0.1/quick-start): Open a koshi session, split a pane, add a tab, and quit — the whole loop in a minute.
  - [Uninstall](/docs/v0.1/uninstall): Remove koshi and every file it wrote — config, themes, logs, update state, cache, and runtime files — on Linux, macOS, or Windows.
  - Using koshi
    - [Sessions](/docs/v0.1/using): A koshi session owns tabs, panes, and the processes inside them; clients attach to it and can be driven from any shell.
    - [Panes](/docs/v0.1/using/panes): Open, place, focus, resize, stack, fullscreen, and close koshi panes from keys or the CLI.
    - [Tabs](/docs/v0.1/using/tabs): Create, close, switch, and reorder koshi tabs with keys or shell commands.
    - [Mouse and copy](/docs/v0.1/using/mouse-and-copy): Focus and resize panes, scroll history, and copy text through OSC 52 with koshi's mouse controls.
    - [Lock mode](/docs/v0.1/using/lock-mode): Pass every key to the focused program, then safely return to koshi shortcuts.
    - [Logging](/docs/v0.1/using/logging): Enable per-session pretty or JSON logs without recording terminal input or copied text.
  - Keybindings
    - [How keys work](/docs/v0.1/keybindings): koshi binds multi-key sequences behind a leader, shows hints while a sequence is pending, and checks for conflicts before a binding can misfire.
    - [Default keymap](/docs/v0.1/keybindings/default-keymap): Every keyboard shortcut koshi ships in normal and locked modes.
    - [Actions](/docs/v0.1/keybindings/actions): Built-in action names available to keybindings and how to inspect their scope and targets.
  - CLI
    - [Conventions](/docs/v0.1/cli): How koshi commands pick their target, what they print, and which output formats they support.
    - [Pane commands](/docs/v0.1/cli/panes): Create, run, close, resize, focus, fullscreen, and write to panes from any shell.
    - [Tab commands](/docs/v0.1/cli/tabs): Create, close, focus, cycle, and reorder koshi tabs from any shell.
    - [Discovery commands](/docs/v0.1/cli/discovery): List sessions, tabs, panes, and clients or inspect one complete record as a table or JSON.
    - [Input lock commands](/docs/v0.1/cli/input-lock): Enable, disable, or toggle pass-through input for one attached koshi client.
    - [Keys and actions commands](/docs/v0.1/cli/keys-and-actions): Inspect effective shortcuts, find conflicts, validate a keybinding file, and explore bindable actions.
    - [Config commands](/docs/v0.1/cli/config): Find, explain, validate, and migrate every koshi configuration file.
    - [Update command](/docs/v0.1/cli/update): Check GitHub Releases, download the matching koshi binary, and replace the running executable safely.
  - Configuration
    - [Overview](/docs/v0.1/configuration): koshi reads four optional KDL files — settings, themes, keybindings, and profiles — each of which must declare a schema version.
    - [koshi.kdl](/docs/v0.1/configuration/koshi-kdl): The main koshi settings file — theme, panes, scrollback, layout, mouse, copy, terminal, logging, and self-update.
    - [Themes](/docs/v0.1/configuration/themes): A koshi theme sets thirteen colours for pane borders, the tab bar, key hints, and stack headers, in themes/<name>.kdl.
    - [keybinding.kdl](/docs/v0.1/configuration/keybinding-kdl): Rebind koshi's keys — leader, chord timeouts, key grammar, and the normal and locked mode blocks.
    - [Profiles](/docs/v0.1/configuration/profiles): Save a whole desk — tabs, pane layouts, commands, working directories, and environment values — and open it with koshi --profile.

  - **Reference**
  - [Changelog](/docs/v0.1/changelog): User-facing changes in each koshi release.