Overview
The user guides for kittymux, grouped by what you are trying to do - get set up, work every day, keep agents in view, and fix problems.
These guides describe what kittymux does today, in the order you are likely to need it.
Get set up
Getting started
Try the demo, install, and spend your first five minutes.
Install and update
Requirements, what the installer changes, upgrading and removing.
Platforms and compatibility
Which kitty versions, desktops and agent CLIs have been tested.
Work every day
Tabs and panes
Join a tab into another, turn a pane into a tab, swap, number and drag.
The tab bar
Read a row, switch modes, resize, and choose which pieces you want.
Peek, deck and panel
See more about a tab with the mouse or the keyboard.
Shortcuts
Every key and mouse gesture in one place.
Keep agents in view
Agent status
The five states, how they are decided and how to ask why.
Notifications and inbox
What reaches you, when, and how to quiet it.
Launch and find agents
Spawn, pick, reopen, fan out and see what an agent changed.
Sessions and restore
Save a workspace and get each agent's conversation back.
Trust and fix
Your own shortcuts
How kittymux treats the keys you already use.
Troubleshooting
Symptoms, causes and fixes.
Privacy and security
What is read, what is stored, and what never leaves your machine.
CLI reference
Every kittymux command.
Scope
kittymux targets Linux with kitty. Wayland and Hyprland are the daily driver; X11 is exercised in a virtual display. macOS is untested. See Platforms and compatibility for the full table.