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