Cappy

The AI developer that lives in your IDE
and answers on WhatsApp.

Run commands.
Check builds.
Approve deploys.

All from WhatsApp.

Your IDE, in your pocket.

_{⭐ Star this repo if the idea makes you smile.}

💡 The Scenario

You're in traffic.

Production just broke.

You open WhatsApp:

You: @api run tests

30 seconds later:

🦫 Cappy: ❌ 2 failing — payment.service.ts:42

You reply:

You: approve hotfix deploy
🦫 Cappy: ✅ Deployed. All green.

Production fixed before you get home.

No laptop. No VPN. No context switch. Just a chat.

�️ Human-in-the-Loop AI

This is what makes Cappy different.

Before any destructive action — git push, deploy, database migration — Cappy asks you for approval. On WhatsApp.

🦫 Cappy: ⚠️ High-risk action requested
   Action: Deploy to production
   Command: npm run deploy:prod
   
   Reply SIM to approve, NÃO to cancel.

You: SIM
🦫 Cappy: ✅ Deployed successfully.

AI that respects your authority — even when you're away from your desk.

🔥 Why developers love Cappy

1️⃣ Control your projects from WhatsApp

Run commands.
Check builds.
Approve AI actions.

All from your phone.

You: @erp run the tests
🦫 Cappy [erp-dsl]: 🧪 47 passing | ❌ 2 failing

You: approve deploy to staging
🦫 Cappy: ✅ Deploying...

No extra apps. No dashboards. If you have WhatsApp, you're ready.

2️⃣ Turn ideas into executable plans

Describe a feature. Cappy analyzes your codebase and creates a structured execution plan — with checklists, acceptance criteria, and step-by-step guidance.

@cappy implement JWT authentication with refresh tokens
@cappy refactor payment module to strategy pattern

3️⃣ Build a portable knowledge base

Drop documents into the dashboard. Query them instantly.

Zero-dependency RAG.

No vector databases.
No external services.
Everything local.

Your codebase and docs become searchable knowledge — stored as plain JSON in your project.

� What Cappy actually is

Cappy is a VS Code extension that connects your IDE to a WhatsApp chat via a secure local bridge.

Your phone becomes a remote console for your projects.

IDE ←→ WebSocket Bridge ←→ WhatsApp
         (port 9090)

No cloud relay. No third-party servers. Everything runs on your machine.

⚡ Features

📊 Dashboard with Tabs

A sleek sidebar with three organized views:

⏰ Task Scheduler

Automate recurring workflows from the dashboard:

• Recurring or one-off execution
• New Chat or Terminal modes
• WhatsApp notifications on completion
• Pause, resume, run on demand

🛠️ 11 Built-in Tools

🚀 Quick Start

Install

Search for "Cappy" in the VS Code / Cursor / Antigravity Marketplace, or:

code --install-extension eduardocecon.cappy

Connect WhatsApp

1. Open the Cappy Dashboard (sidebar icon 🦫)
2. Click Connect WhatsApp
3. Scan the QR code
4. Start chatting with your IDE 🎉

Add a Notebook

1. Go to the 📓 Notebooks tab
2. Click the + drop zone
3. Select files — they're chunked, embedded, and indexed automatically
4. Query with @cappy — results come from your own knowledge base

🏗️ Architecture

Compatible Editors

• VS Code (1.105.0+)
• Cursor
• Antigravity IDE

🗺️ Roadmap

🧑‍💻 Development

npm install                # Install dependencies
npm run compile-extension  # Compile
npm test                   # Run tests
npm run package            # Package .vsix

📄 License

MIT — see LICENSE

⭐ If Cappy helps you, please star the repo — it makes a difference.

Built with 🧡 by Eduardo Cecon
_{Designed for developers who hate context switching.}