Guide

Usage

Sessions, splits, tabs, and workspace management
Properties3
Is BaseNo
Iconi-lucide-layers
Order20

Windows and Tabs

Kytos uses native macOS windows and tabs. Each window and each tab is backed by a KytosWorkspace — an observable split tree of terminal panes.

  • Cmd+N — new window
  • Cmd+T — new tab
  • Cmd+W — close tab / window

Splits

Splits are managed by KytosWorkspace's split tree model. Panes can be split horizontally or vertically.

  • Cmd+D — split horizontally
  • Cmd+Shift+D — split vertically
  • Cmd+[ / Cmd+] — navigate between panes

Shell Integration

Kytos includes Ghostty's shell integration scripts for bash, zsh, fish, elvish, and nushell. When active:

  • The toolbar title updates to the current process name
  • The toolbar subtitle updates to the working directory
  • Navigator pane labels reflect the active process

Shell integration is automatic if your shell sources the integration script. Ghostty's shell integration injects via OSC escape sequences — no manual configuration needed.

TabContent
FilesProject file tree for the current working directory
SessionsAll open workspaces and panes

Inspector Panels

The inspector shows metadata about the focused pane: process, working directory, and terminal dimensions.

Utility Area

The utility area provides a secondary terminal or output view below the editor area.