AI Workflow

Troubleshooting the claude-resume TUI

How I built a TUI for finding and resuming Claude Code sessions, then fixed encoding, key conflicts, recursive calls, and screenshot handling.

May 17, 2026

Goal

The default Claude Code resume flow made it hard to identify past sessions quickly. I built a two-panel TUI with a session list on the left and conversation preview on the right.

Problems Fixed

  • Korean text broke in Windows CMD and PowerShell until UTF-8 handling was forced.
  • TUI key bindings conflicted with the resume handoff flow.
  • The summarizer could accidentally include its own session logs, creating recursive noise.
  • Screenshots and sensitive visual context needed masking before being reused.

Result

The tool became a practical session picker that can summarize, preview, and resume previous Claude Code work without reading large JSONL files manually.