Picker and sessions

Open the picker

shirei
# Equivalent to:
shirei pick

fzf displays the 4 ordered sections: sessions, recent directories, worktrees, and roots. Canceling the picker exits successfully without changing anything.

List sessions

shirei sessions

The configured backend supplies the result. A leading * marks the attached tmux session or focused Herdr workspace.

Close sessions

shirei kill

Use Tab in fzf to select sessions and Enter to close them. There is no second confirmation after Enter.

Danger

Closing a session terminates its live processes. It does not delete directories or Shirei state. Run shirei kill only with an interactive terminal and deliberate selection.

tmux behavior

With the default tmux backend, Shirei creates or reuses a session derived from the directory name. Inside tmux it switches the current client. Outside tmux it attaches and can block until you detach.

Add a convenient picker binding to ~/.tmux.conf:

bind-key -r f run-shell "tmux neww shirei"

Press your tmux prefix followed by f to launch Shirei in a new window.

Herdr behavior

Set the backend in ~/.config/shirei/config.toml:

backend = "herdr"

Shirei maps projects to Herdr workspaces. From a normal shell it starts the Herdr server when necessary and attaches after selection.

Add a command binding to ~/.config/herdr/config.toml:

[[keys.command]]
key = "prefix+f"
type = "pane"
command = "shirei"

To use Ctrl-a as the Herdr prefix:

[keys]
prefix = "ctrl+a"

The backend changes session mechanics, not Shirei’s picker or worktree commands.