Every turn, in one card.

See what Claude changed and whether the tests passed.
Read the one line to check before you trust it.
Every raw line stays one click away.

A mod for Claude Code. No network. No processes. MIT.

Your files. Your tests. Your checks. One card.

Read the READMEView on GitHub

Quick start

Install notes
Install

Install from the marketplace

One line in a Claude Code terminal session. The card works in fullscreen and in the main screen.

/plugin install tldr --marketplace kushalBanda/claude-tldr

Needs Claude Code 2.1.301 or later. Before you install, you can run claude plugin validate on a clone: it lists every event and API the mod uses.

The same turn, three ways

Login-bug fixture · real card
~/shop · claude

> fix the login bug, users get logged out after refresh

  1. 01⏺ I'll start with how sessions are refreshed.
  2. 02
  3. 03⏺ Read(src/auth.py)
  4. 04 ⎿ Read 84 lines
  5. 05
  6. 06⏺ Search(pattern: "decode\(")
  7. 07 ⎿ Found 6 files
  8. 08
  9. 09⏺ Read(src/middleware.py)
  10. 10 ⎿ Read 41 lines
  11. 11
  12. 12⏺ The refresh path rebuilds the expiry from the old issue time.
  13. 13
  14. 14⏺ Update(src/auth.py)
  15. 15 ⎿ Updated src/auth.py with 12 additions and 3 removals
  16. 16 41 - exp = payload["iat"] + TTL
  17. 17 41 + exp = time.time() + TTL
  18. 18 … +14 lines (ctrl+o to expand)
  19. 19
  20. 20⏺ Bash(pytest tests/test_auth.py -q)
  21. 21 ⎿ Error: ..F.F...F...
  22. 22 FAILED tests/test_auth.py::test_refresh_keeps_session
  23. 23 … +38 lines (ctrl+o to expand)
  24. 24
  25. 25⏺ Update(src/middleware.py)
  26. 26 ⎿ Updated src/middleware.py with 4 additions and 1 removal
  27. 27
  28. 28⏺ Update(tests/conftest.py)
  29. 29 ⎿ Updated tests/conftest.py with 2 additions and 2 removals
  30. 30
  31. 31⏺ Bash(pytest tests/test_auth.py -q)
  32. 32 ⎿ ............
  33. 33 12 passed in 1.62s

What it does

  • Turn card

    One card per turn in place of the tool rows: goal, time, files, test runs in order, other commands and what Claude read. The final reply stays.

  • Trust flags

    The card turns amber and says what to check: a test file edited in the turn that made tests pass, writes outside the project, deletes, skip markers, --no-verify, force pushes.

  • Click to reveal

    Click a row and a pane shows what is behind it. Click the goal for the turn as steps. Escape closes it. Every raw line stays one click away.

  • Reads your tests

    Test runs read red to green, in order. Wrappers like npm test, make test and tox resolve to the runner they start.

  • Context bar

    One line above the prompt: conversation in blue, setup in gray. The conversation turns amber at 60% and red at 80%, pointing to /compact.

  • Mode-aware spinner

    Thinking, running tools or writing, with the current job: Reading src/auth.py. It moves during /compact too.

  • Kept cards

    Finished cards survive /compact and resume, up to 50 per session. /tldr history lists them.

  • Copy and diff

    Copy the reply as clean text, with no trailing spaces or shared indentation, or print the net diff of the turn per file.

  • Local only

    It reads the turn statically. No network calls, no processes. TypeScript, no dependencies, MIT.

Reads your test runner

How tests are read
  • pytest
  • unittest
  • jest
  • vitest
  • Playwright
  • go test
  • gotestsum
  • cargo test
  • nextest
  • bun test
  • deno test
  • npm test · pnpm test · yarn test · make test · just test · toxWrappers, read through the runner they start

Know how full the window is.

One line above the prompt. It uses Claude Code's own local estimate, so no request is sent.

Type 7 or run /tldr context for the setup rows.

62% full · conversation 94k · setup 30k · /compact

>

  • Conversation

    What you and Claude said, and the tool results. /compact frees it.

  • Setup

    System prompt, tools, memory, skills. Every request loads it.

  • Amber at 60%

    The conversation and the percent turn amber when the window is 60% full.

  • Red at 80%

    It turns red and points to /compact. You decide when to compact.

Two layouts

Terminal only · desktop and VS Code draw their own rows

Fullscreen: the card takes clicks.

The card replaces the tool rows. Click a row to open its pane. Escape closes it.

fullscreen · click a row
fix the login bug, users get logged out after refresh14:02 · 52s
Changed3 files +18 −6src/auth.py, src/middleware.py, tests/conftest.py
Testspytest ✗ 3 failed → ✓ 12 passed
Check⚠ tests/conftest.py changed in the turn that made tests pass
Looked at2 files, 1 searchclick a row ▸
diff

Main screen: rows become keys.

Printed rows can't take a click, so the band above the prompt holds them as digits. Type one into the empty prompt.

scrollback · press 1 to 6
fix the login bug, users get logged out after refresh14:02 · 52s
Changed3 files +18 −6src/auth.py, src/middleware.py, tests/conftest.py
Testspytest ✗ 3 failed → ✓ 12 passed
Check⚠ tests/conftest.py changed in the turn that made tests pass
Looked at2 files, 1 searchclick a row ▸
diff
TL;DR

>

Commands

All commands
  • /tldr

    Help.

  • /tldr show [row]

    Open what's behind a row of the latest card: changed, tests, check, ran, looked, notes. With no row, the steps of the turn in order.

  • /tldr context

    Open the context pane: each category that fills the window, with its tokens and share.

  • /tldr history

    Open the kept cards of this session, newest first.

  • /tldr copy

    Copy the latest reply as clean text: no trailing spaces, no shared indentation.

  • /tldr diff

    Print the net change of the latest turn per file, as a unified diff.

Switches

/plugin configure tldr@claude-tldr

  • One card per turn.

    Off. Claude Code's own rows. Also turns off trust, keep and actions.

  • The mode-aware spinner.

    Off. Claude Code's own spinner.

  • Motion moves.

    Off. Motion keeps its colours but doesn't move.

  • The context bar above the prompt.

    Off. No context bar.

  • The Check row and the amber border.

    Off. No Check row, no amber border.

  • Cards kept after /compact and resume.

    Off. Nothing saved, no note after /compact.

  • Copy and diff.

    Off. No buttons, no copy or diff commands.

  • All seven are on by default. Flip one to see what off means. Turning card off also turns off trust, keep and actions.

Install

Read the turn, not the scroll. One line, no restart, in any Claude Code terminal.

Install command

/plugin install tldr --marketplace kushalBanda/claude-tldr

Who made it

Privacy and trust

TL;DR is an MIT project by Kushal Banda. It is not affiliated with Anthropic.

It reads the tool calls and results of your session, and the files Claude edits. No network calls, no processes. Kept cards stay on your machine, at most 50 per session, with no diff bodies.

More from Kushal