ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add berkayturanci/keel
/plugin install keel-progress@keel
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.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

A sample of three demo runs above the prompt: one in review, one stopped with its gates blocked, and one in its fix loop.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold oneBash
  • command.runWhen you run its slash command/keel-progress
  • ui.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
Repo
berkayturanci/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

Other mods in Workflow

squad-chatchrisluo5311Opens a pane to chat with friends on your squad's own Supabase, plus rooms for usage, git, and every session's subagents.agent-monitorGarvitNangruDraws a progress bar above the prompt as each plan step finishes, and a panel of the plan and every subagent's model, context, and cost.rllvmh1994stFor rllvm, which pulls LLVM bitcode out of a build, draws a read-only pane of the call-graph overlay. Skills and a query server come in the same install.goblin-utilJasonWarrenUKDraws a /fleet pane of every Claude Code session on this machine and sends a message to the one you pick. The same install's /pain logs friction.roadmapJasonWarrenUKDraws a /ready pane of the tasks ready in a dependency-graph roadmap and claims the one you pick. Skills in the same install update the graph.agent-flowluucas42Draws the main model, an advisor, and every subagent as cards joined by arrows in a side pane, plus every Claude Code session on this machine.grounded-engineeringmadjagstudiosDraws a pane of source-backed engineering practices that fit this repo, and Adapt asks Claude to bring one in. Skills come in the same install.pr-paneNongfsqIn the desktop app, draws a pane of this project's sessions sorted by what each needs from you, with pull requests and CI. Ask sends a prompt about one.decision-popupSzotaszDraws a frame around the question dialog and has Claude ask each decision there as a one-key choice.focus-modeSzotaszDraws a subtask list above the prompt and keeps the final answer, hiding tool calls and the rest of the turn while it is on.project-paneSzotaszDraws a side pane of this repo's git, pull requests, CI, deploys, and Supabase, and fast-forwards the branch when you press Sync.tool-hubSzotaszDraws a button under the prompt that opens switches for the other mods on this marketplace.
All 396 in Workflow