All shelves / Mods / Workflow
train-progress
By HanlongLi
train-progress is a Claude Code workflow mod by HanlongLi.
Draws progress bars under the prompt for training runs and other long jobs, with step counts, metrics, and an ETA, and /progress panel opens the full list.
Draws
Install
The marketplace name is local-mods.
/plugin install train-progress --marketplace hanlongli/train-progressIt 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.3.1
- License
- MIT
- Repo stars
- 3
- Last change
- 2026-10-21
What it can reach
- Draws in the session
python3, standard library only. Jobs come from tp run, which wraps any command and reads its progress from the output, from the Python helper, or from TensorBoard event files under the project's logs folder with no code change. The tp command installs from a clone: git clone https://github.com/hanlongli/train-progress && train-progress/train-progress/install.sh. The bar shows while a job is running or just ended, and /config picks every job on the machine or this session's.
The marketplace, local-mods, holds only this plugin; the same repository also gives Codex a live footer and OpenCode a toast. A long job's progress is why this page files it under workflow. tqdm-claude, by ExtReMLapin, draws tqdm-style bars for background tasks and subagents, read from each task's output. lightning, by Lightning-AI, draws a bar for each Lightning AI job. This one is for any job on the machine, a training run, a build, a download, or a test suite, and keeps each as a JSON file in ~/.train_progress/, so a job started outside Claude shows too. A job that has not reported for 15 minutes shows as stalled. In the source, the plugin starts python3 to watch TensorBoard logs.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/progress/trainui.renderDraws into the sessionPromptHintPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 2
/progress/train
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- HanlongLi
- Category
- Workflow
- Marketplace
- local-mods
- Folder
- train-progress
- Version
- 0.3.1
- License
- MIT
- Repo stars
- 3
- Last change
- 2026-10-21
- Language
- Python
- Files
- 20