gitwtfhub

wtf is txviewer?

eviking/txviewer — explained in plain English

Analysis updated 2026-05-18

15PythonAudience · developerComplexity · 1/5Setup · easy

TL;DR

A terminal viewer for Claude Code sessions that shows what Claude is doing in real time, tool calls, file edits, shell commands, and token usage, in a split-pane interface with no installation required beyond Python 3.8.

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

Python

How it stacks up

eviking/txviewer13127905/deep-learning-based-air-gesture-text-recognition-6xvl/paralives-plugins-index
Stars151515
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity1/53/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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.

Frequently asked questions

wtf is txviewer?

A terminal viewer for Claude Code sessions that shows what Claude is doing in real time, tool calls, file edits, shell commands, and token usage, in a split-pane interface with no installation required beyond Python 3.8.

What language is txviewer written in?

Mainly Python. The stack also includes Python.

What license does txviewer use?

No license information was mentioned in the explanation.

How hard is txviewer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is txviewer for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.