claude-sessions

TL;DR: Run claude-sessions, pick a session, press enter. Claude Code opens right where you left off.

Table of Contents

• Why
• Features
• Install
• Usage
• Key Bindings
• Clean Mode
• Requirements

Why

Claude Code stores sessions per directory but gives you no way to navigate them. This tool:

• Lists all your sessions (chat + code) sorted by last activity
• Lets you jump straight back into any session with enter
• Separates chat sessions (~/.chats/) from code sessions (project dirs)
• Keeps your session data clean with an interactive cleanup mode

Features

| Category | Highlights | | ---------- | ------------------------------------------------------------------- | | Navigation | Sorted by last activity, grouped by type (chat / code) | | Search | Fuzzy filter by name or path with / | | Filter | Toggle between all / chat / code views with tab | | New chat | Create a named chat session and open it immediately | | Delete | Remove a session's history and directory with confirmation | | Clean mode | Interactive cleanup of ghost entries, stale pointers, orphaned dirs |

Install

npm install -g @kud/claude-sessions-cli

Usage

claude-sessions         # open the TUI
claude-sessions clean   # clean up stale session data

TUI

/ search…

  + New chat

── chat ────────────────────────
▶ 󰭹  Hey         ~/.chats/hey           just now
  󰭹  Planning    ~/.chats/planning      2h

── code ────────────────────────
  󰏗  my-project  ~/Projects/my-project  yesterday
  󰏗  api         ~/Projects/api         3d

↑↓ nav  enter open  d remove  / search  tab filter  C clean  q quit   [all] chat code

Key Bindings

| Key | Action | | ----------- | ---------------------------------- | | ↑ ↓ | Navigate | | enter | Open session in Claude Code | | d | Remove session (with confirmation) | | / | Search by name or path | | tab | Cycle filter: all → chat → code | | C | Open clean mode | | q / esc | Quit |

Clean Mode

Scans ~/.claude.json and ~/.claude/projects/ for stale data. Issues are grouped by type — select which categories to clean before confirming. Nothing is deleted without confirmation.

| Type | Meaning | Action | | ---------------- | ------------------------------------------------------------------------ | ---------------------------- | | ghost | Entry in ~/.claude.json but the project directory no longer exists | Remove from ~/.claude.json | | no history | Entry in ~/.claude.json with no conversation history | Remove from ~/.claude.json | | orphaned history | History in ~/.claude/projects/ with no matching ~/.claude.json entry | Trash the history folder |

Available as both a TUI mode (C key) and a standalone subcommand (claude-sessions clean).

Requirements

• Node.js ≥ 24
• Claude Code installed (claude in PATH)
• trash for safe deletes (npm install -g trash-cli)