All shelves / Mods / Workflow
keel-progress
By berkayturanci
keel-progress is a Claude Code workflow mod by berkayturanci.
Draws each live keel run above the prompt and in a side pane, read from keel status and the run's activity file.
Draws
Install
The marketplace name is keel.
/plugin marketplace add berkayturanci/keel /plugin install keel-progress@keel
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.7.0
- License
- Apache-2.0
- Repo stars
- 6
- Last change
- 2026-10-07
What it can reach
- Draws in the session
- Reaches the network or an outside service
- Sees tool calls
- Calls another program on this machine
Keel is a project-neutral workflow backbone that takes one GitHub issue from intake to a merged pull request. In Claude Code the agent runs the keel commands, and keel's CLI enforces the steps. This folder only draws the live runs inside Claude Code, so you do not need a second terminal on the keel visual dashboard. It never writes the checkpoint or the ledger and never drives a run. Needs Claude Code 2.1.287 or newer, with mods enabled for your account. The README says that if claude plugin test prints that hooks modules are turned off in this process, mods are off for your account and no local setting turns them on. Install keel itself first, start Claude Code in the directory that holds .keel/project.yaml, and have keel on PATH. A session shows its own keel runs only: the ones in its folder and in the worktrees keel made under it. Show other sessions' runs starts off. Turn it on to see every recently active worktree of the repository. Above the prompt, one row per live run shows the issue, the backbone as a bar of chips, the current step, why it is waiting or stopped, the pull request as a link, and how long since keel last wrote. The session's own run is first. Nothing is drawn when no run is live. The band shows 3 runs, the default, and more lists the rest. Click a run's issue to open the pane on that run. Pointing at the step bar or the branch shows more at the right end of the row. The README says no hook runs as the pointer moves. /keel-progress opens a side panel and closes it when it is open. Refresh reads again. The checkpoint is read with keel status --json. The activity file is read from disk. The first read asks keel activity --json where those files live. Whichever of the two was written last is shown. The mod lists worktrees with git worktree list. A pull request is hidden once it is no longer open. That check is gh pr list for open pull requests, at most once a minute, and once more when a scan meets a pull request the list does not hold. Without gh, nothing is hidden on those grounds. Who drives a run, the host, the agent, the model, and the effort, comes from the activity record, and for a run that has a pull request the agent and model labels fill any field the record lacks, from that same gh list. Notifications start on: a toast when a run stops, waits for you, or leaves the board. Sound starts off. While a run is live the state is read every 2 seconds, the default, and five times less often when none is live. keel status itself runs only when a checkpoint changed, at most every 30 seconds while a run is live, and not in an idle session whose checkpoint has not moved. A scan also runs right after any Bash call that runs keel. The README says other hosts are not affected, and that only Claude Code's plugin loader reads this directory.
The marketplace name is keel. The same marketplace also lists keel, the backbone plugin. This mod installs on its own. The rows of live keel runs are why this page files it under workflow. plan-progress draws live progress bars above the prompt, one row per task with its stages, steps, and the subagents under it. These rows are keel's own runs.
Demo
What it hooks into
session.startWhen a session startstool.callAround a tool call, where it can hold oneBashcommand.runWhen you run its slash command/keel-progressui.renderDraws into the sessionAbovePromptPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/keel-progressShow this repository's live keel runs: every step, history counts and the next issue
Files
The author's README and source, 5 files. They load when you open them.
Facts
- Author
- berkayturanci
- Category
- Workflow
- Marketplace
- keel
- Folder
- mods/keel-progress
- Version
- 0.7.0
- License
- Apache-2.0
- Repo stars
- 6
- Last change
- 2026-10-07
- Language
- Python
- Files
- 11