Shirei CLI

Shirei is a small terminal session switcher for people who move between many projects and Git worktrees. It combines live tmux sessions or Herdr workspaces, recent directories, registered worktrees, and configured project roots in one fzf picker.

cargo install shirei
shirei

One picker

Switch among active sessions, recent directories, worktrees, and project roots.

Worktree aware

Create or attach branch worktrees and open them directly in your terminal backend.

Backend neutral

Use tmux sessions or Herdr workspaces with the same commands.

Small state

No daemon or database. Shirei keeps recent directories and worktrees in one JSON file.

Selection behavior

Selecting a live entry activates it. Selecting a directory creates or reuses a backend session, activates it, and records the path as recent.

Rows are grouped in this order:

1. SESSION: live tmux sessions or Herdr workspaces.
2. RECENT: directories opened through Shirei.
3. WORKTREE: tracked linked worktrees.
4. ROOT: directories found under configured roots.

Earlier groups win. A directory already represented by a live session is hidden from later groups.

Common workflows

# Open the main picker
shirei

# Open or create a branch worktree
shirei branch feature/my-change --base main

# Inspect unfinished work
shirei worktrees unfinished

# Rebuild Shirei's worktree registry
shirei worktrees scan

Shirei shells out to standard tools instead of replacing them. Continue with installation, sessions and the picker, or branch worktrees.