claudeboss

A terminal UI for browsing and managing Claude Code sessions.

What it does

claudeboss reads your ~/.claude/projects/ directory and presents all your Claude Code sessions in a navigable ncurses interface. You can:

• Browse sessions sorted by recency or context size
• Filter by work/personal category
• See AI-generated summaries of each session
• View detailed session info with file trees and temporal logs
• Resume any session directly in a new terminal

Installation

pip install claudeboss

Requirements

• Python 3.10+
• Linux (uses curses, /proc filesystem, X11 detection)
• Claude Code CLI (claude) installed and authenticated
• Optional: wmctrl for active session detection

Usage

claudeboss

Navigation (vim-style)

Actions

Detail View

Features

• Live active detection: Running Claude sessions show with green highlight
• Smart summaries: Sessions get 3-6 word titles generated by Haiku
• Delta updates: Only regenerates summaries when sessions grow significantly
• Responsive layout: Detail view adapts between 2-column and single-column
• Background processing: Summaries and temporal logs generate without blocking

Configuration

Work/personal detection patterns can be customized in ~/.config/claudeboss/patterns.json:

{
  "work_patterns": ["mycompany", "work-project", "client-name"]
}

License

MIT