Skip to content
Arashi logo Arashi

tmux and sesh

Use this guide when terminal windows, panes, and sessions are the main way you move between Arashi worktrees.

tmux

Use tmux when you want terminal-native switching and multiple worktrees open at once.

Terminal window
arashi switch feature-auth
arashi switch --cd feature-auth
  • arashi switch can open a new tmux window when Arashi detects a tmux session.
  • arashi switch --cd is useful when you want to keep the current shell and jump directly into the worktree path.
  • Combine tmux with defaults.switch.mode when your team wants a consistent terminal flow.

sesh

Use sesh when you want tmux session selection to be part of your default worktree navigation.

Terminal window
arashi switch --sesh feature-auth
  • Good for teams that treat each worktree as a session-oriented workspace.
  • Works well with defaults.create.launchMode or defaults.switch.launchMode set to "sesh".
  • Pair with shortcut flows such as sesh connect "$(arashi list | fzf)" when you want faster session selection.

Choosing Between Them

  • Pick tmux when you want worktree switching to stay inside terminal windows or panes.
  • Pick tmux plus sesh when you want session-aware switching and consistent multi-window navigation.
  • Use --cd when you want Arashi to prepare the target path without opening a new terminal context.