Quick start

The very first katu you ever run writes a default katu.toml, prints three lines confirming it, and drops you straight into a main session — no setup wizard. Every run after that is just this:

katu                     # attach to the last session, or create "main"
katu start api           # create and attach to session "api"
katu join api            # attach to an existing session
katu list                # show all sessions
katu split               # split the current pane side by side
katu split --horizontal  # split the current pane top/bottom
katu window new          # open a new window (tab)
katu stop api            # kill one session
katu stop --all          # kill the server and every session
katu reload              # apply katu.toml changes without restarting anything
katu resurrect           # recreate sessions saved at the last clean shutdown
katu completions fish > ~/.config/fish/completions/katu.fish

Detach with ctrl+space then d. The shell keeps running in the background.

Build from source

git clone https://github.com/simaojunior/katu
cd katu
direnv allow          # or: nix develop
cargo build --release