Tmux Claude

tmux-claude

tmux plugin for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Codex](https://openai.com/index/introducing-codex/) session management.

Two features:

1. Stable naming — starting Claude in a pane creates a fresh session with a tmux-derived name, with explicit opt-in resume
2. Save/restore — survives tmux server restart (reboot) via tmux-resurrect integration

Requirements

• tmux >= 3.2
• TPM
• tmux-resurrect (for save/restore)
• python3 (for session lookup)

Install

set -g @plugin 'bezlant/tmux-claude'

`prefix + I` to install.

Setup

1. SessionStart hooks (required for save/restore)

These hooks write session IDs to tmux pane variables so the plugin can map panes to sessions.

**Claude Code** — add to `~/.claude/settings.json`:

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "bash ~/.config/tmux/plugins/tmux-claude/scripts/claude-session-hook.sh"
      }]
    }]
  }
}

**Codex** — add to `~/.codex/hooks.json`:

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "bash ~/.config/tmux/plugins/tmux-claude/scripts/codex-session-hook.sh"
      }]
    }]
  }
}

2. Shell wrapper (stable naming)

The plugin auto-installs the fish wrapper on `prefix + I`. For other shells:

# Bash (add to ~/.bashrc)
source ~/.config/tmux/plugins/tmux-claude/shell/claude.bash

# Zsh (add to ~/.zshrc)
source ~/.config/tmux/plugins/tmux-claude/shell/claude.zsh

To disable fish auto-install:

set -g @tmux-claude-auto-install-wrapper off

Features

Stable Claude Naming

Each pane gets a stable session name derived from its tmux window name:

• Single-pane window redbot → session name redbot
• Multi-pane window redbot, pane 2 → session name redbot.2

When you type `claude`