claudeboss 0.1.0

Terminal UI for browsing and managing Claude Code sessions

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)

Key	Action
j / k	Move cursor down / up
l / Enter	Open detail view
h / q	Back / quit
g / G	Jump to top / bottom
Ctrl+U / Ctrl+D	Page up / down

Actions

Key	Action
s	Toggle sort: time / size
c	Cycle filter: all / personal / work
R	Regenerate summary for current session
m	Open menu
?	Help

Detail View

Key	Action
j / k	Scroll content
l / Enter	Resume session in new kitty terminal
h / q	Back to list

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