Abby:~/Projects/cc-session-board$ cat README.md

Claude Code Session Board 📋

A curses-based TUI for browsing, searching, and resuming past Claude Code conversation sessions.

📄 session_board.py 📄 gen_title.py 📋 README

> Demo

Claude Code Session Board Sort: lines ↓ │ Filter: _ ────────────────────────────────────────────────────────── 1199 ~/Desktop Build 152 study site + todo board Apr 14 847 ~/Desktop/151b FPGA project checkpoint 2 debug Apr 8 623 ~/Desktop Avicena interview prep Apr 16 412 ~/Desktop/161 Secure file sharing proj2 Apr 3 298 ~ OpenClaw RPi setup + Telegram bot Apr 6 156 ~/Desktop Organize chat sessions Apr 14 89 ~/Developer Focus fish script Mar 28 ────────────────────────────────────────────────────────── ↑↓ navigate │ l sort lines │ d sort date │ / filter │ ↵ resume

> Features

🔍 Ranked by Activity

Sessions sorted by line count (most activity = most important). Toggle to date sort with `d`.

🏷️ Auto-Generated Titles

Extracts first user message as session title. Background reindex keeps titles fresh.

⚡ Fuzzy Search

Press `/` to filter by title or project path. Instant results as you type.

↵ One-Key Resume

Press Enter on any session to resume it in Claude Code with full context.

📂 Project Path Display

Shows which directory each session was in — quickly find project-specific conversations.

📦 Zero Dependencies

Pure Python stdlib. ~370 lines. Scans ~/.claude/projects/ JSONL files.

> How It Works

~/.claude/projects/           ← Claude Code stores sessions here
  -Users-abby-Desktop/
    cc0b9d59-...jsonl           ← each file = one conversation
    77c1679f-...jsonl
  -Users-abby-Desktop-151b/
    4ba2cfac-...jsonl

session_board.py scans these, extracts titles, caches in titles.json,
renders a curses TUI for browsing and resuming.

> Tech Stack

Python 3 · curses · json · pathlib · subprocess · Claude Code CLI

cd ../