Sesh

Replace the legacy seshcli/seshcli.go logic with a new Cobra root command structure. Instead of using app.Run(), use fang.Execute() to run the command tree.

// Before (urfave)
app := seshcli.App(version)
app.Run(os.Args)

// After (Cobra + Fang)
cmd := seshcli.NewRootCommand(version)
fang.Execute(context.TODO(), cmd)

Sesh works by leveraging zoxide for directory tracking and tmux for session management.

• sesh list: Lists all current tmux sessions and zoxide search results.
• sesh connect {session}: Connects to a specific session. If the session does not exist, it is automatically created.

Sesh supports tab completion for Bash, Zsh, Fish, and PowerShell. Follow the specific steps for your shell to generate and install the completion scripts.

# Bash
sesh completion bash > sesh-completion.bash
sudo cp sesh-completion.bash /etc/bash_completion.d/
source ~/.bashrc

# Zsh
sesh completion zsh > _sesh
sudo mkdir -p /usr/local/share/zsh/site-functions
sudo cp _sesh /usr/local/share/zsh/site-functions/
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -U compinit && compinit' >> ~/.zshrc
source ~/.zshrc

# Fish
sesh completion fish > ~/.config/fish/completions/sesh.fish
source ~/.config/fish/config.fish

# PowerShell
sesh completion powershell > sesh.ps1
mkdir -p (Split-Path $PROFILE)
Add-Content $PROFILE ". /path/to/sesh.ps1"
& $PROFILE

When working in nested sessions, you can use the --root flag to connect to the root session of a git worktree or repository.

Recommended tmux binding:

bind -N "switch to root session (via sesh) " 9 run-shell "sesh connect --root $(pwd)"

The sesh status command prints a tmux-styled string describing the GitHub issue associated with the current session's branch. It displays a state badge (green OPEN or red CLOSED) followed by the issue number and title.

To use it in your tmux configuration (e.g., in status-left or status-right), add a line like this:

Requirements:

• The gh CLI must be installed and authenticated (gh auth login).
• The issue number must be present in the branch name (e.g., 400 or feat/400-status-bar).

If no issue is found, the branch has no number, or the gh CLI is unavailable, the command prints nothing and exits with code 0, ensuring your status bar remains clean.

set -g status-left "#[fg=blue,bold]#S #[fg=white,nobold]#(sesh status)"

To enable tab completion for Sesh in Zsh, generate the completion script and add it to your site-functions or a custom completions directory, then reload your shell.

# Generate completion script
sesh completion zsh > _sesh

# Install system-wide (recommended)
sudo mkdir -p /usr/local/share/zsh/site-functions
sudo cp _sesh /usr/local/share/zsh/site-functions/

# Or install user-only
mkdir -p ~/.zsh/completions
cp _sesh ~/.zsh/completions/
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -U compinit && compinit' >> ~/.zshrc

# Reload your shell
source ~/.zshrc

You can configure sesh by creating a sesh.toml file in $XDG_CONFIG_HOME/sesh or $HOME/.config/sesh.

To create the default configuration directory and file, run:

mkdir -p ~/.config/sesh && touch ~/.config/sesh/sesh.toml

To install Sesh on macOS or Linux using Homebrew, run the following command:

brew install sesh

You can automatically rename tmux sessions to include the GitHub issue title associated with the current branch. This requires the gh CLI to be installed and authenticated.

Add this hook to your tmux.conf to run the enrichment in the background whenever a new session is created:

set-hook -g session-created 'run-shell -b "sesh rename --enrich"'

Depending on your package manager, use one of the following commands:

For Conda or (micro)mamba users:

conda -c conda-forge install sesh

For Pixi users:

pixi global install sesh