# claudeboss

A terminal UI for browsing and managing Claude Code sessions.

![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)
![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
![Platform: Linux](https://img.shields.io/badge/platform-Linux-lightgrey.svg)

## 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

```bash
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

```bash
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`:

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

## License

MIT
