v2.0.0  ·  CLI Tool

Session manager for
Claude Code

Browse, resume, organise, and clean up all your Claude Code sessions from one interactive terminal interface.

Get started View on GitHub
npm install -g @kud/claude-sessions-cli@next
v2.0.0 Latest
3 Subcommands
MIT Licence
Node 24+ Required
Features

Everything you need to
manage your sessions

A focused TUI that keeps your Claude Code workflow fast and organised.

🗂

Three-tab interface

Code sessions grouped by project, Chat sessions with pins and tag folders, and a Scheduled tab — all navigable with arrow keys.

🔁

Instant resume

Press enter on any session and Claude Code opens right where you left off, using the correct --resume, --continue, or --name flag automatically.

⭐

Pin & tag chat sessions

Star important chats to the top. Group others into collapsible #tag folders so your session list stays navigable no matter how many chats you have.

🪄

Auto CLAUDE.md creation

New chat sessions get a CLAUDE.md bootstrapped automatically. Preview any session's CLAUDE.md in-place with m without leaving the TUI.

🧹

Clean mode

Interactive cleanup of ghost entries, history-less projects, and orphaned history folders. Available as both a key binding (C) and the clean subcommand.

🔍

Live search

Filter sessions by name or path as you type. Press / anywhere in the list to enter search mode — results update instantly with every keystroke.

Quick Start

Up and running in seconds

Install globally from npm, then launch the TUI. No config required.

Install 
npm install -g @kud/claude-sessions-cli@next
Launch the TUI 
claude-sessions
Session browser 
  ✻ Claude

   Code   Chat   Scheduled

  / search…

  › + New chat

  › + my-api        (3)             2h
    + my-site        (1)         yesterday
    + dotfiles       (2)              5d

  ↑ ↓ navigate · enter resume · / search · C clean · q quit

Pick a session with ↑ / ↓ and press enter. Claude Code opens immediately, resuming that exact conversation.

CLI Reference

Commands & key bindings

Every action available in the TUI and from the command line.

Subcommands

claude-sessions Open the interactive TUI session browser
claude-sessions clean Run the standalone clean-up wizard without opening the full TUI
claude-sessions --no-banner Open the TUI, skipping the animated intro banner

Tabs

Code Sessions from project directories, grouped by project with expand/collapse per group
Chat Sessions from ~/.claude-sessions/chats/ with pin stars and #tag folders
Scheduled Placeholder for scheduled tasks (coming soon)

Key bindings

↑ ↓ Navigate the session list
← → / tab Switch tabs or cycle to the next tab
enter Open or resume the selected session in Claude Code
space Expand or collapse the selected project / tag group
d Delete session or all sessions for a project (with confirmation)
r Rename the selected Code session label
p Pin or unpin (★) the selected Chat session
t Set or remove a #tag for the selected Chat session
m Preview the session's CLAUDE.md inline
f Open the session folder in Finder
/ Enter search mode — filter sessions by name or path as you type
C Open clean mode to remove stale entries and orphaned history
q / esc Quit the TUI

Clean mode categories

ghost In ~/.claude.json but the project directory no longer exists — removed from ~/.claude.json
no history In ~/.claude.json with no conversation history — removed from ~/.claude.json
orphaned history History in ~/.claude/projects/ with no matching ~/.claude.json entry — trashed