Holds a planning mode: Claude writes the plan, you review it in a browser page, a band shows above the prompt, and other writes are refused while it plans.
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.18.2
License
MIT
Repo stars
6
Last change
2026-10-26
What it can reach
Draws in the session
Holds a command
Calls another program on this machine
Needs Claude Code with mods; an older build loads them only with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1, and where they are off the skill still writes a plan. bun must be on the PATH, since the review server is a Bun script, and the page needs a recent Chromium or Firefox. Managed settings with an allowedMcpServers key at all keep the mode from starting. /vellum:start is yours to run; Claude never starts it. Claude proposes the next step, settles open choices in a grill on the page, and writes plan.md in a working directory under plans/. On the page you comment on blocks, edit the plan, see what changed since the last version, and Send or Approve; Approve renames the directory after the plan's title. /vellum:stop leaves the mode and keeps the directory. On Claude Code Desktop, a prompt the plugin sends while the session is idle does not show until you type in the session.
The marketplace name is bengous-plugins. The marketplace also holds secret-pane, todos, and other plugins. This one installs on its own and brings a plan-reviewer agent. Reviewing a plan before it is built is why this page files it under review. plannotator opens Claude's plan in a review UI and sends your annotations back. crit-tui opens a pane to comment on lines of the conversation, the diff, or a file. This one orders the plan by what you are most likely to change and holds the session while it plans: edits to the project outside its working directory are refused, and so is a shell command that moves into that directory. A review server per session runs on 127.0.0.1.
Demo
Screenshot of the author's GitHub page.
What it hooks into
session.startWhen a session starts
skill.promptA Claude Code event
command.runWhen you run its slash command/clear/resume
ui.renderDraws into the sessionAbovePrompt
tool.checkA Claude Code event
tool.callAround a tool call, where it can hold onemcp__vellum__submitmcp__vellum__statemcp__vellum__grill_askmcp__vellum__proposeAskUserQuestion
prompt.submitWhen you send a prompt
session.appendWhen an entry is written to the transcript
turn.startWhen Claude starts a turn
turn.completeWhen a turn ends
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 14 files. They load when you open them.