---
title: "tldr"
url: "https://claudemods.dev/en/builds/tldr-825fdb"
source: "https://github.com/kushalBanda/claude-tldr"
source_type: "github"
repo: "https://github.com/kushalBanda/claude-tldr"
author: "kushalBanda"
author_handle: "kushalBanda"
stars: 0
category: "Dashboards & HUD"
categories: ["hud"]
tags: ["cards", "context-tracking", "hooks", "statusline", "test-parsing", "tui"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add kushalBanda/claude-tldr\nclaude plugin install tldr@claude-tldr"
added: "2026-10-18T07:53:15.294Z"
updated: "2026-10-18T08:09:39Z"
locale: "en"
content_locale: "en"
---

# tldr

TL;DR for Claude Code: every turn as one card, with what to check.

## Description

# TL;DR for Claude Code

**Every turn, in one card.** What changed, how the tests went, and what to check before you trust it.

The plugin renders each Claude Code turn as a single card covering changed files, test results and trust checks, plus a context bar and session history. Install with `/plugin install tldr --marketplace kushalBanda/claude-tldr`. MIT licensed, TypeScript with no dependencies, and no network calls.

## Install

```
claude plugin marketplace add kushalBanda/claude-tldr
claude plugin install tldr@claude-tldr
```

## Original README

# TL;DR for Claude Code

**Every turn, in one card.** What changed, how the tests went, and what to check before you trust it.

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
![Version](https://img.shields.io/badge/version-0.1.2-orange.svg)
![Claude Code](https://img.shields.io/badge/Claude%20Code-2.1.301%2B-d77757.svg)
![No network calls](https://img.shields.io/badge/network%20calls-none-success.svg)

![Left: a Claude Code turn as 33 lines of reads, edits and test logs. Right: the same turn as one TL;DR card that flags the changed test file, and the steps pane under it.](.github/assets/before-after.png)

![33 lines become 5 rows. A Check row flags edits that can fake a green run. No network calls.](.github/assets/value.png)

## Install

In a Claude Code terminal session, type:

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

Answer `y` to add the marketplace, then pick a scope (user is the first one). The mod starts at once, with no restart. It needs Claude Code 2.1.301 or later.

## Features

![A card with an amber border lists four checks: a write outside the project, a deleted file, an added skip marker, and skipped hooks with a force push.](.github/assets/trust.png)

![The Changed row is open inside the card: files grouped by folder, with the first diff lines of auth.py.](.github/assets/reveal.png)

![A spinner reads "Running pytest", and one TL;DR line above the prompt shows files, the red-to-green test runs and the current job.](.github/assets/progress.png)

![Three context bars: 38% full in blue, 62% full in amber, and 86% full in red with a pointer to /compact.](.github/assets/context.png)

![On the main screen, the band above the prompt shows the rows as digit keys. Key 3 opens the test runs under it.](.github/assets/band.png)

![The /tldr history pane lists two kept cards, newest first.](.github/assets/history.png)

Also: `/tldr copy` copies the reply as clean text, and `/tldr diff` prints the net diff of the turn. On desktop and in VS Code, Claude Code draws its own rows. The card is for the terminal.

## Reference

<details>
<summary><b>Commands</b></summary>

| Command | Does |
| --- | --- |
| `/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. Escape closes it. |
| `/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. |

</details>

<details>
<summary><b>Switches</b></summary>

Every feature is a switch, and all are on by default. Change them with `/plugin configure tldr@claude-tldr` in Claude Code.

| Switch | Off means |
| --- | --- |
| `card` | Claude Code's own rows. Also turns off `trust`, `keep` and `actions`. |
| `motion` | Claude Code's own spinner. |
| `animation` | Motion keeps its colors but doesn't move. |
| `context` | No context bar. |
| `trust` | No Check row, no amber border. |
| `keep` | Nothing saved, no note after `/compact`. |
| `actions` | No buttons, no copy or diff commands. |

</details>

<details>
<summary><b>Tests it reads</b></summary>

pytest, unittest, jest, vitest, Playwright, go test, gotestsum, cargo test and nextest, bun test, and deno test. It also reads `npm`, `pnpm` and `yarn test`, `make test`, `just test` and `tox`: it finds the summary of the runner they start. For `go test`, counts need `-v`, and a compile error reads `✗ build failed`. Runs that only list tests (`--collect-only`, `--listTests`) don't count.

</details>

<details>
<summary><b>Privacy and trust</b></summary>

- **No network.** TL;DR makes no network calls and starts no processes.
- **Local only.** It reads the tool calls and results of your session, and the files Claude edits, to build the net diff. The context bar uses Claude Code's local estimate of the window, so it sends no request. Kept cards stay in Claude Code's local plugin store: one list per session, at most 50 cards, without diff bodies.
- **Check it yourself.** Before you install, run `claude plugin validate` on a clone. The `hooks:` and `calls:` lines list every event the mod handles and every API it calls.

</details>

<details>
<summary><b>Limits</b></summary>

- Changes made through Bash count when they use a redirect, a heredoc, `tee`, `sed -i`, `perl -i`, `cp`, `mv`, `touch`, `git checkout -- path` or `git restore`. They show as `path via Bash`, without line counts. Writes from scripts (`python x.py`), `git apply` and `git stash pop` don't show. A path built from a variable (`> $OUT`) is left out.
- A `cd` counts inside one command (`cd app && touch x`), but not when it ran in an earlier call.
- When grep or tail cuts `go test` output, the card keeps the failures it sees but drops the pass count. A summary line (gotestsum, or a wrapper's own) keeps all counts.
- Bulk deletes (`find -delete`, `git clean -f`, `xargs rm`) are flagged by command, not file by file.
- A task runner that starts two test runners (`make test` that runs `go test` and then `vitest`) shows the first summary it finds, not the sum.
- The custom spinner takes the place of Claude Code's spinner line, so the token count doesn't show. Switch `motion` off to get it back.
- If Claude writes the same text twice in one turn, as a note and as the reply, it can fold away with the note. `/tldr show notes` brings it back.

</details>

<details>
<summary><b>Develop</b></summary>

```bash
git clone https://github.com/kushalBanda/claude-tldr && cd claude-tldr
claude --plugin-dir .          # run it; a save reloads the mod
claude plugin validate .       # manifest, marketplace and hooks
claude plugin test .           # the test suite (tests/*.test.ts*)
```

The mod is TypeScript with no dependencies. Render hooks are pure, and all parsing is static: TL;DR never runs a command to learn what a command did. See [CONTRIBUTING.md](CONTRIBUTING.md) to send a change.

The images in this README are mock-ups of the mod's output.

</details>

## Contributing

Bug reports, ideas and pull requests are welcome. Use the [issue forms](https://github.com/kushalBanda/claude-tldr/issues/new/choose). A screenshot of the card helps a lot. To report a security problem, see [SECURITY.md](SECURITY.md).

## License

[MIT](LICENSE) © Kushal Banda