Stop Guessing. Start Building.

Nudge Dev is a revolutionary VS Code extension designed to sit exactly where the magic happens: between you and your AI coding agent (Cursor, Claude Code, GitHub Copilot). We fix the "Garbage In, Garbage Out" loop by building a bullet-proof pre-flight routine.

Workflow · Core Features · Commands · Git Safety-Net

🎯 The Mission: Fix "Garbage In, Garbage Out"

Developers often face two critical issues when working with AI agents:

Ambiguity: Vague prompts lead to guesswork and hours of wasted work.
Regression: Agents finish a task but silently break existing features.

Nudge Dev transforms your raw thoughts into a hardened, atomic task plan through four powerful steps:

Step	Description	AI Model
🔍 Clarify	Fills architectural gaps with 4-6 smart, tap-able questions.	Gemini 2.0 Flash
🤝 Debate	10 AI experts (Security, DBA, etc.) cross-examine the plan.	Council Models
⚖️ Judge	Merges opinions into a structured task list with risk levels.	DeepSeek R1
🛡️ Guard	Verifies completion against git diffs and test output.	DeepSeek V3

🔑 Core Features

1. 🔍 Clarification Engine

Simply type what you want to build. In seconds, Nudge Dev scans your prompt and generates 4–6 fast, tap-able questions to fill in missing architectural gaps. No forms. No text fields. Just tap and go.

2. 🤝 The Debate Council (10 AI Experts)

Your clarified prompt is sent to a council of 10 AI models (DeepSeek V3, Llama 4, Mistral, etc.). They take on personas—from a skeptical Security Engineer to a strict DBA. A "Judge" model merges their findings, highlighting risks and consensus areas.

3. ✍️ Interactive Draft Mode

Nudge Dev intuitively knows which files are relevant. Use the Draft Mode to drag, drop, and edit the AI-generated tasks to perfection before dispatching them to your agent.

4. 🛡️ Guard Loop Verification

Never fear rogue agents again. After every task, Nudge Dev automatically verifies completion. If all 3 automatic fix attempts fail, it alerts you with the exact issues found.

🛡️ Git Safety-Net (The "Panic Button")

Before any task is sent to your agent, Nudge Dev silently creates an automatic git backup branch. If the agent hallucinates or makes unwanted changes, simply press the "🚨 Revert Everything" (Panic Button), and your codebase is instantly restored to its previous clean state.

🚀 Quick Start

1. Install backend dependencies

cd backend
npm install

2. Configure environment

cp .env.example .env
# Edit .env and add your OpenRouter API key

3. Start the backend server

node backend/server.js
# Server runs on http://localhost:3847

4. Build and run the extension

cd extension
npm install
npm run compile

Open the extension/ folder in VS Code and press F5 to launch. Click the Rocket Icon in the Activity Bar.

⌨️ Commands and Shortcuts

Feature	Shortcut	Command Palette
🚀 Open Co-Pilot	`Cmd+Shift+P`	`Nudge Dev: Open Co-Pilot`
🔍 Start Guard Loop	`Cmd+Shift+G`	`Nudge Dev: Start Guard Loop`
🗑️ Clear Session	—	`Nudge Dev: Clear Session`

📁 Project Structure

nudge-dev/
├── backend/          # Express API server (Node.js)
│   ├── routes/       # Clarify, Debate, Guard endpoints
│   ├── services/     # Multi-model orchestration
│   └── db/           # SQLite session memory
└── extension/        # VS Code extension (TypeScript)
    ├── src/          # Extension logic & Bridge
    └── media/        # WebView assets (Vanilla HTML/CSS/JS)

Nudge Dev — Because even the best pilots need a co-pilot before takeoff.

Nudge Dev — AI Agent Co-Pilot