kylesnowschwartz

Tail Claude — Development skill for Claude Code

Development community

A Go Bubble Tea TUI for reading Claude Code session JSONL files.

How to install Tail Claude

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kylesnowschwartz/tail-claude and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tail Claude does

A Go Bubble Tea TUI for reading Claude Code session JSONL files.

Alternatives in Development

Ccusage — CLI for analyzing Claude Code/Codex usage from local JSONL files 11.8k ★
Memory Gc — Inspect or rotate the autopilot ledger JSONL files (findings.jsonl, negatives.jsonl) 3.8k ★
Ccundo — Integrates seamlessly with Claude Code to provide granular undo functionality by reading directly from Claude 1.4k ★

README

tail-claude

A terminal UI for reading Claude Code session JSONL files. Built with Go and [Bubble Tea](https://github.com/charmbracelet/bubbletea).

Reads session logs from `~/.claude/` and renders them as a scrollable conversation with expandable tool calls, token counts, and live tailing.

tail-claude demo

Requirements

Go 1.25+
A Nerd Font patched terminal font

Install

go install github.com/kylesnowschwartz/tail-claude@latest

Or build from source:

git clone git@github.com:kylesnowschwartz/tail-claude.git
cd tail-claude
go build -o tail-claude .

Update

tail-claude --update

Or manually:

go install github.com/kylesnowschwartz/tail-claude@latest

Usage

Run `tail-claude` to open the most recent session. If the session is stale (>12 hours), the session picker opens instead.

Pass a path directly to skip discovery:

tail-claude ~/.claude/projects/-Users-kyle-Code-foo/session.jsonl

CLI flags

tail-claude [flags] [session.jsonl]
  --dump          Print rendered output to stdout (no interactive TUI)
  --expand        Expand all messages (use with --dump)
  --width N       Set terminal width for --dump output (default 160, min 40)
  --update        Update to the latest version via go install
  -v, --version   Show version
  -h, --help      Show this help

Keybindings

`?` toggles keybind hints in any view. `Ctrl+z` suspends the TUI (resume with `fg`).

**List view**

Key	Action
`j` / `k`	Move cursor down / up
`↑` / `↓`	Scroll viewport 3 lines
`J` / `Ctrl+d`	Page down (half page)
`K` / `Ctrl+u`	Page up (half page)
`G` / `g`	Jump to last / first message
`Tab`	Toggle expand/collapse current message
`e` / `c`	Expand / collapse all Claude messages
`Enter`	Open detail view
`d`	Open debug log viewer
`t`