Skip to content

Installation

Grab the binary for your platform from GitHub Releases. No Python required.

curl -L -o clsm https://github.com/ritwik-g/claude-session-manager/releases/latest/download/claude-session-manager-macos-arm64
chmod +x clsm
xattr -cr clsm                    # clear macOS quarantine
sudo mv clsm /usr/local/bin/

curl -L -o clsm https://github.com/ritwik-g/claude-session-manager/releases/latest/download/claude-session-manager-linux-x86_64
chmod +x clsm
sudo mv clsm /usr/local/bin/

Download claude-session-manager-windows-x86_64.exe from Releases and place it on your PATH.

macOS quarantine

The first time you download an unsigned binary on macOS, Gatekeeper marks it with a quarantine attribute. xattr -cr clsm strips that attribute so the binary can run.

Via pip / pipx

pipx install claude-session-manager
# or
pip install claude-session-manager

This installs both the claude-session-manager and clsm commands.

From source

git clone https://github.com/ritwik-g/claude-session-manager.git
cd claude-session-manager
pip install .

Requirements

  • Claude Code sessions on disk under ~/.claude/
  • Python 3.10+ (only if installing from source / pip — pre-built binaries have no Python requirement)