Ketchup Fast-Forward — VS Code Extension

Visual Studio Code extension for Ketchup: detect and sync drift between your local workspace and the expected project state.

Install: VS Marketplace — Reskyume.ketchup-fast-forward

Requirements

VS Code 1.85.0 or later
Ketchup CLI installed and available on PATH (or configured via ketchup.cliPath)
A workspace with .ketchup.yml or .ketchup.yaml

cd extension
npm install
npm run compile
npm run package

Then in VS Code: Extensions → ... → Install from VSIX and select ketchup-fast-forward-0.3.0.vsix.

Sidebar panel — live status for Git, Dependencies, and Environment providers
Status bar — clean / drift / error indicator with issue count
Quick-fix actions — contextual actions on findings (catch-up, sync)
Auto-check — runs status when the workspace opens
Output channel — detailed logs under "Ketchup"
CLI update check — optional startup check for new core releases

Command	CLI equivalent
Ketchup: Check Status	`ketchup status`
Ketchup: Show Diff	`ketchup diff`
Ketchup: Sync Workspace	`ketchup sync`
Ketchup: Run Doctor	`ketchup doctor`
Ketchup: Catch Up	`ketchup catch-up` (uses settings / project config)
Ketchup: Catch Up (Show All Changes)	`ketchup catch-up --show all`
Ketchup: Check for Updates	`ketchup update --check`
Ketchup: Refresh Status	refreshes sidebar

Setting	Default	Description
`ketchup.cliPath`	`ketchup`	Path to the CLI executable
`ketchup.autoCheckOnOpen`	`true`	Auto-run status on workspace open
`ketchup.showNotifications`	`true`	Show drift/completion notifications
`ketchup.showStatusBar`	`true`	Show status bar indicator
`ketchup.autoUpdate`	`true`	Check for CLI updates on startup
`ketchup.catchUpShow`	`relevant`	Catch-up mode: `relevant` or `all`
`ketchup.catchUpExplain`	`false`	Include relevance scores in catch-up output

The extension runs the Ketchup CLI as a subprocess: