Changelog.
Every release of Vibeflow, dated and linked. This page is generated from the repository changelog on each deploy, so it never drifts from what actually shipped.
Worth reading on its own
Highlights.
Cross-cutting changes worth reading about on their own. Everything else is in the release table below or in the per-package changelogs.
-
The MCP server is stable as of 0.18.0. It shipped in 0.12.0 under a warning that it could change without notice; that warning is gone from the CLI help, the tool manifests and the release notes. The surface a client can pin to now resolves one project root per server, answers every refusal with a code and a recovery hint, and honours
dryRunas a preview that writes nothing. See the MCP guide. -
Refusals are machine-readable on every surface. A refusal is
{ok:false, error:{code, message, retryable, suggestion?}}on the CLI, over HTTP and over MCP — one parser, one vocabulary, and one recovery text per code, naming the CLI flag and the MCP input so a client is never told to use a flag it does not have. -
An empty board is a success on both surfaces.
tasks --next --jsonand MCPclaim_next_tasknow answer the same situation the same way (task: null), instead of one exiting 0 with prose and the other refusing with a code.
Release history
Releases.
| Version | Date | What changed |
|---|---|---|
| 0.18.1 | 29 September 2026 | show all version changelogs jumped since last seen version in What's New modal |
| 0.18.0 | 29 September 2026 | Breaking, on both surfaces: "no work available" is a success, and the MCP payload says notices. |
| 0.17.2 | 26 September 2026 | Fix the board's comment API routes not awaiting their writes. POST/PATCH/DELETE on |
Older releases (30)
| Version | Date | What changed |
|---|---|---|
| 0.17.1 | 20 September 2026 | Stop shipping demo media in the npm tarball. Removed the orphaned docs/demo/ directory (5 GIFs, 5 MP4s, 5 WEBMs, 1 PNG) and dropped it from the package files list — the README already links the showcase from https://www.vibeflow.tools/assets/demo/showcase.gif, so the local copies were unused. Package size drops from 28.1 MB to 1.1 MB. |
| 0.17.0 | 19 September 2026 | Add --set-verify pass|fail|cannot tri-state flag for task verification. Replaces the old boolean --verified/--verify-failed/--unset-verified with a more expressive system: |
| 0.16.0 | — | Replace the --verified / --verify-failed / --unset-verified attestation flags with a single tri-state --set-verify pass|fail|cannot flag plus --verify-reason (required for cannot). BREAKING: the three old flags and --skip-verify are removed — callers must switch to --set-verify. Semantics: pass attests the task IS implemented correctly (verified=true, green badge, review allowed); fail attests it is NOT correct (verified=false, amber badge, review BLOCKED); cannot with --verify-reason "<why>" clears the verdict to absent (no badge) and records the reason in the task's activity so the detail panel shows it. Omitting a verdict on an annotated task at the review transition now blocks with an error naming all three options (--set-verify pass|fail|cannot). |
| 0.15.0 | 18 September 2026 | Theming support: pick from six curated themes — Dark, Light, High contrast, Rosé Pine Dawn, Dracula and Gruvbox Dark — in Settings → Theme, where each is a swatch chip with a live preview. Apply commits it, Cancel reverts. Built on design tokens, so every surface (board, cards, detail panel, modals) follows the theme. |
| 0.14.0 | — | Remove-link dialog: child-aware confirmation with move-up/delete-children radio options, server-side detach endpoint, and board-level wiring. |
| 0.13.0 | 6 September 2026 | Expand watch notifications + output modes |
| 0.12.1 | — | Fix verify gate: skip enforcement when no baseline.json exists |
| 0.12.0 | 5 September 2026 | MCP server: streamable HTTP endpoint at /api/mcp exposing 10 task tools (list_tasks, get_task, create_task, update_task, claim_next_task, add_comment, attach_file, export_prompt, verify_task, push_tasks). Manifest-driven — new CLI commands are auto-discovered. Auth: loopback-only locally, Bearer token for SaaS. Session management with 30-min TTL. |
| 0.11.0 | 1 September 2026 | feat(cli): startup banner always shows a localhost URL alongside the LAN IP |
| 0.10.0 | 29 August 2026 | Add a vibeflow watch command that watches the local task store and prints full ticket details whenever a task is newly created or moved back to todo. |
| 0.9.1 | — | fix(cli): align tRPC/REST semantics, add router tests, and harden agent API |
| 0.9.0 | — | Add "🎨 Prototyping" option to the overlay page-level right-click context menu when @vibeflow-tools/prototyping is installed. Clicking the option opens the variant switcher panel via the __vf_prototyping API. |
| 0.8.1 | 29 May 2026 | Increase kanban multi-select long-press timeout to 750ms with drag cancellation |
| 0.8.0 | 27 May 2026 | Replace select button with long-press multiselect and change default task limit |
| 0.7.0 | 26 May 2026 | Use default agent from settings in the agent picker dropdown, pre-selecting the configured default agent when opening the Agent tab. |
| 0.6.1 | 24 May 2026 | Add current git branch name display in kanban header, reorder workflow settings toggles, and fix agent instruction step numbering for createBranch workflow. Also add 'editing' state to collaborative editing event types. |
| 0.6.0 | 23 May 2026 | Add agent queue side panel with button in header |
| 0.5.1 | — | Include agent workflow instructions in agent run context. Previously, vibeflow tasks --get printed CLI instructions but the server agent-run endpoint did not include them in the prompt sent to opencode. Now both entry points share the same renderAgentInstructions() formatter, ensuring agents always receive workflow rules, settings flags, and critical constraints. |
| 0.5.0 | — | tasks --next now supports combining with --type, --user, and --tag filters to pick the next available todo task matching specific criteria. |
| 0.4.2 | — | Fix task file corruption when multiple processes write simultaneously. |
| 0.4.1 | — | Fix overlay API/kanban URLs pointing to wrong host when used as bookmarklet on non-CLI pages. Detect server origin from document.currentScript.src instead of window.location.host. |
| 0.4.0 | — | Replace manual version:patch/minor/major npm scripts with Changesets CLI (@changesets/cli) for versioning and changelog management. Agents now create .changeset/*.md files; the publish script runs pnpm changeset version to apply all pending changesets before publishing. |
| 0.3.2 | 24 April 2026 | add comprehensive error handling to board creation endpoints (workspace.create, workspace.createWithBoard) with detailed logging of input, user ID, and root error cause |
| 0.3.1 | 24 April 2026 | improve error logging to capture comprehensive diagnostic details: extract full stack traces, error types, and file locations from any error-like value (Error, string, object, arbitrary values) |
| 0.3.0 | 24 April 2026 | require X-Overlay-Api-Key header on GET /api/overlay/tasks — overlay GET endpoint is now authenticated (breaking: clients must include API key) |
| 0.2.1 | 24 April 2026 | fix telemetry config path to use lazy evaluation so tests correctly isolate HOME override |
| 0.2.0 | 24 April 2026 | inline token search field with #tag picker — type # to open tag autocomplete dropdown; active tag chips appear as removable pills inside the search box (Proposals 1 + 3 combined) |
| 0.1.2 | 24 April 2026 | add --tag filter to tasks command — filter tasks by one or more tags |
| 0.1.1 | 10 April 2026 | initial kanban board browser UI |
| 0.1.0 | 1 April 2026 | initial release: serve, tasks, push, auth commands |
Generated from the CLI package changelog on every release. Each tagged version links to its GitHub tag page; releases published before tagging began are shown without a date. The newest three are listed above, the rest are collapsed.
Full history
Where the detailed notes live.
Detailed, per-package changelogs are maintained inside each package of the public repository. Start with the repository changelog or browse the npm package.