ClaudeCodeMod

All shelves / Mods / Workflow

tqdm-claude

By ExtReMLapin

tqdm-claude is a Claude Code workflow mod by ExtReMLapin.

Draws tqdm-style progress bars above the prompt for background tasks and subagents, read from each task's output, and flags crashes, stalls, and quiet failures.

Draws

Install

The marketplace name is tqdm-claude.

In Claude Code
/plugin install tqdm-claude --marketplace ExtReMLapin/tqdm-claude
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.2.0
License
MIT
Repo stars
5
Last change
2026-10-18

What it can reach

  • Draws in the session
  • Sees tool calls

Needs Claude Code 2.1.302 or later. The mod is active at once; start a long command in the background to see it. From a shell, claude plugin install tqdm-claude --marketplace ExtReMLapin/tqdm-claude does the same. It reads progress from tqdm, cargo, git, ffmpeg, test runners, and many more tools, or from a one-line progress protocol for your own scripts, and it adds a short note on that protocol to Claude's system prompt. A summary also goes at the end of the hint line under the prompt. Settings in /config: charset, footer, agents, notify for native notifications when a task fails, and stuck, which warns when a turn has had no tool call for 3 minutes. /tqdm lists the tasks it follows, and /tqdm clear drops finished and failed ones. Where an organization manages Claude Code, hooks on prompt.compose and classic.Stop run only for plugins it lists.

The marketplace name is tqdm-claude, and it holds only this plugin. Following background work is why this page files it under workflow. peek-vedantandhale opens a pane of background shells and subagents with their last output lines. plan-progress draws progress bars for the tasks in Claude's plan. This one reads each background task's own output for a real percentage and an ETA, and keeps a failed task on the band with its exit code and error line until you dismiss it. In the source, it draws AbovePrompt, PromptHint, and SessionMode renders, and a tool.call hook on Bash notes each background task's output file.

Demo

The author's recording of tqdm-claude in a terminal: under Claude's reply, in French, and Brewed for 8s · 4 shells still running, a band lists the background commands with tqdm-style bars: Build RAG index at 2/4 with chunks 2300/6000, ok 2299, fail 1; Cargo release build at 261/312; Download wikitext-103 at 1.05G of 1.72G; and Fine-tune llama-3b with its epochs and batches. The bars fill as the commands run, Build RAG index fails with exit code 1 · KeyError: 'path' and a red ✗, and the download finishes with a ✓. The commands and figures are the author's sample.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/tqdm
  • prompt.composeWhile you write a prompt
  • prompt.submitWhen you send a prompt
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold oneBashPowerShellAgentTaskStop
  • classic.SessionStartA Claude Code event
  • classic.StopA Claude Code event
  • session.appendWhen an entry is written to the transcript
  • ui.renderDraws into the sessionSessionModePromptHintAbovePrompt

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /tqdmTask progress band: `/tqdm` lists tasks, `/tqdm clear` drops finished ones

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
ExtReMLapin
Category
Workflow
Marketplace
tqdm-claude
Repo
ExtReMLapin/tqdm-claude
Version
0.2.0
License
MIT
Repo stars
5
Last change
2026-10-18
Language
TypeScript
Files
55

Other mods in Workflow

showboardrohanbeingsocialOpens a pane of boards Claude builds from your spreadsheets or database: headline numbers, charts, tables, and notes, each figure from a read-only query.table-exportUginimDraws export buttons under each markdown table in a reply: copy it as TSV, Markdown, box art, HTML, or a PNG, or save it as a CSV file.homiehomie-rocksHolds a commandDraws a studio band and panes for a game build, its rooms, and parallel parts, and holds production deploys, paid media calls, and edits to protected files.muslimabdelrahmanziedDraws a thikr in Claude's working line, athkar and the next prayer by the prompt, and in the desktop app a Quran player and a Muslim pane.rookBake-WareOpens a Rook pane of your band's workers, their Claude Code and Codex sessions, and the task deck, and mirrors this session to a local Rook worker by default.skillmapsbardaxxOpens side panes that map AI Hero skill runs: a /grill-me session as a design tree, a /wayfinder map as a graph, and a spec's stages, subagents, and tickets.feature-progressdougcunhaAdds a tool any spec-driven flow calls to report a feature's progress, with a band above the prompt for the stage and count and a pane of every task.topic-guarddougcunhaBefore a prompt you type enters the session, has Haiku judge whether it starts a new topic, and holds it with a New session button that clears the chat for it.quick-repliesFynnXlandTurns Claude Code's own next-message suggestion into a button above the prompt, sent as your message on a click or its digit, with up to three more from a fork.sidekickFynnXlandChecks each message just before it is sent and draws a blue line under it with a better move: a new chat with a handoff, a clearer version, or a skill.skill-heaven-consolegaia-researchFor Skill Heaven, draws a skill count by your status line, a /lens band that previews a summon, and a /heaven pane of what entered context and what you trust.xcpanegrichesTurns xcodebuild and swift build output into a live pane of errors grouped by file, and hands Claude the parsed diagnostics instead of the raw log.
All 396 in Workflow