Progress Ring
See how far Claude is in a long plan, above the prompt.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add alvaro-hi/progress-ring
/plugin install progress-ring@progress-ring
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add alvaro-hi/progress-ring
claude plugin install progress-ring@progress-ringThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "Progress Ring" (https://github.com/alvaro-hi/progress-ring). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add alvaro-hi/progress-ring and claude plugin install progress-ring@progress-ring, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/alvaro-hi/progress-ring
cd progress-ring
claude --plugin-dir .Clone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads cards in ~/.claude/progress, session id and folder, hook event data, and the transcript to total tokens.
Writes files
YesWrites JSON cards and an error log under ~/.claude/progress via a local CLI; clearing moves cards to _done/.
Runs commands
YesRuns python3 bin/progress_hook.py and bin/progress from the plugin folder; open or xdg-open to jump to a chat.
Network
NoneIntroduction
Progress Ring is a Claude Code function-hooks mod by Álvaro del Pozo. When Claude starts a plan of three or more steps it opens a progress card and closes each step as it finishes. A band above the prompt shows a percentage ring, the current step, the plan, and whether Claude is working, waiting for you or stalled; a /progress panel lists every plan in this and other chats, subagents awaiting review, and a jump to the owning chat; milestone rows in the conversation read “Now: X · ✓ closed · N/M”.
- Cards live in
~/.claude/progress, written by a local Python CLI; the percentage counts only closed steps. - It adds a usage rule to the system prompt and one line of card state to each prompt.
- Author notes: python3 3.9+, macOS or Linux, tested only on Claude Code 2.1.287; the interface follows the system language (Spanish or English).
Not run by us; written from the README and manifests; the preview is illustrative.
Who it is for
- People running long multi-step plans who want to see progress
- Users with several chats who want one view of every plan
Requirements
- Claude Code ≥ 2.1.287
- Platforms · macOS / Linux
- Needs python3 3.9 or later on the PATH.
- Author only says “tested on 2.1.287”; no stated minimum.