Command reference

Command	Interactive	Description
`shirei`	Yes	Open the main picker; same as `shirei pick`
`shirei pick`	Yes	Open the main picker explicitly
`shirei branch [name]`	Sometimes	Open an existing branch worktree or create one after choosing a base
`shirei branch <name> --base <ref>`	Session switch only	Create a named branch from a known base or open it if it exists
`shirei recent`	No	Print saved recent directories
`shirei sessions`	No	Print live sessions from the configured backend
`shirei kill`	Yes	Select live sessions or workspaces to close
`shirei completions <shell>`	No	Generate Bash, Elvish, Fish, PowerShell, or Zsh completions
`shirei worktrees`	No	Print tracked worktree registry entries
`shirei worktrees unfinished`	No	Report potential unfinished work without active or merged reviews
`shirei worktrees scan`	No	Rebuild the registry from discovered Git worktrees
`shirei worktrees prune`	Yes	Select and permanently delete worktrees and local branches

Help and version

shirei --version
shirei --help
shirei branch --help
shirei worktrees --help

Automation boundaries

Shirei currently has no JSON output, noninteractive picker mode, or command that changes the parent shell’s directory.

Treat these as interactive:

shirei and shirei pick.
shirei branch when name or base requires a picker.
shirei kill.
shirei worktrees prune.

Read-only commands such as recent, sessions, worktrees, and worktrees unfinished are suitable for reports, but their output is human-oriented and can evolve.

Exit behavior

Canceling an fzf picker normally exits successfully without acting. A zero status therefore does not prove a selection or mutation occurred.