Ripple VS Code Extension

Bring requirement-driven development directly into VS Code and compatible editors. Track approved requirements, manage acceptance criteria, and start implementation with AI-ready context — all without leaving your editor.

Features

Requirements Sidebar: View requirements that are ready for development (In Development, In Review, Done) — backlog items stay out of your way until approved
Start with AI: Generate rich requirement context and send it to your detected AI agent chat when supported (with clipboard fallback)
Acceptance Criteria Tracking: Mark ACs complete directly from VS Code
Auto File Linking: Files you edit are automatically linked to the active requirement for traceability — no manual linking needed
CodeLens Integration: See the active requirement inline in your code
Commit Message Generation: Generate a requirement-scoped commit message with one command
Status Bar: Always see your active requirement at a glance

Installation

Install from the VS Code Marketplace
Or install from Open VSX for Cursor, Windsurf, VSCodium, and other compatible IDEs
Sign in with your Ripple account when prompted
Select a project and pick a requirement to start working

Workflow

Select a requirement — use the sidebar or Cmd+Shift+E
Start with AI — click "Start with AI" on the requirement card
Check the result toast:
- If direct injection succeeds, your agent chat opens with context
- If not, context is copied to clipboard for manual paste
Implement — the agent has full context: user story, acceptance criteria, subtasks, related code
Commit — use Cmd+Shift+M; Ripple sets the message in the Source Control input box (and copies to clipboard as backup)

Commands

Command	Shortcut	Description
`Ripple: Open Sidebar`	`Cmd+Shift+R`	Open/focus Ripple sidebar
`Ripple: Select Requirement`	`Cmd+Shift+E`	Quick-pick to select active requirement
`Ripple: Generate Commit Message`	`Cmd+Shift+M`	Generate commit message from active requirement
`Ripple: Mark AC Complete`	`Cmd+Shift+C`	Mark selected acceptance criterion as complete

Windows/Linux: Replace Cmd with Ctrl

Optional Settings (Advanced)

Most users do not need to change any settings.

Setting	Default	Description
`ripple.apiUrl`	`https://try-ripple.vercel.app`	Ripple API base URL
`ripple.autoSync`	`true`	Auto-sync requirements in background
`ripple.syncInterval`	`30`	Sync interval in seconds
`ripple.showCodeLens`	`true`	Show CodeLens annotations in editor
`ripple.showStatusBar`	`true`	Show active requirement in status bar

Supported AI Agents

The "Start with AI" feature detects and names the active agent automatically:

Maintainers

Development and release/publishing steps are intentionally kept out of this end-user README.

Ripple - Requirement Traceability

Try-ripple