eviking/txviewer

★ 15PythonAudience · developerComplexity · 1/5Setup · easy

Mindmap

mindmap
  root((txviewer))
    What it does
      Watch Claude Code live
      Browse past sessions
      Track token usage
      Session summary chart
    Interface
      Split pane terminal
      Turn list left pane
      Tool details right pane
      Vi-style navigation
    Token Tracking
      Cache hit rate
      Uncached input tokens
      Output tokens
      Per-turn breakdown
    Tech Stack
      Python
      Standard library only

mindmap root((txviewer)) What it does Watch Claude Code live Browse past sessions Track token usage Session summary chart Interface Split pane terminal Turn list left pane Tool details right pane Vi-style navigation Token Tracking Cache hit rate Uncached input tokens Output tokens Per-turn breakdown Tech Stack Python Standard library only

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Watch Claude Code work through a task in real time without leaving your terminal.

USE CASE 2

Review a past Claude Code session to see every file it touched, command it ran, and tool it called, turn by turn.

USE CASE 3

Monitor token cache hit rates across a session to understand whether your Claude Code setup is using context efficiently.

USE CASE 4

Get a session-wide activity summary with bar chart after Claude finishes a long task.

Tech stack

Python

Getting it running

Difficulty · easy Time to first run · 5min

Requires Python 3.8 or later, no additional packages needed. Only tested on Mac with one specific Claude Code version.

No license information was mentioned in the explanation.

In plain English

txviewer is a terminal-based viewer for Claude Code sessions. It lets you watch in real time what Claude is doing as it works through a task. The tool reads the transcript files that Claude Code automatically writes to your computer and displays them in a split-pane interface right in your terminal. The left pane shows a list of turns in the current session. The right pane shows details for the selected turn: which tools Claude called, what files it read or edited, what shell commands it ran, and a token usage breakdown for that turn. You can navigate through turns with arrow keys or vi-style shortcuts, toggle live mode to follow along as Claude works, or press "s" to see a session-wide summary with a bar chart of activity. Token tracking is a notable part of the display. Each turn shows how many tokens were served from Anthropic's prompt cache (the cheaper kind), how many were new uncached input, and how many output tokens Claude generated. A cache hit percentage gives a quick sense of how efficiently the session is using context. The session summary can show this data as token spend instead of step count when per-step data is available. The tool runs entirely on Python's standard library, so there is nothing to install beyond Python 3.8 or later. You run it with a single command and it attaches to the most recent active session. You can also pass a session ID or a full file path to open any past session. The README notes it was only tested with one specific version of Claude Code on a Mac, so behavior on other setups may vary.

Copy-paste prompts

Prompt 1

Run txviewer and attach it to my active Claude Code session so I can watch tool calls and file edits as they happen.

Prompt 2

Using txviewer, show me the token usage breakdown for each turn in session ID abc123, I want to see cache hits vs uncached input.

Prompt 3

I want to inspect a specific past Claude Code session with txviewer by passing a full file path instead of the session ID. How do I do that?

Prompt 4

Help me extend txviewer to add a filter that shows only turns where Claude ran a shell command, hiding read-only turns.

Open on GitHub → Explain another repo

← eviking on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.