- Overview
- Key Features
- Architecture
- Tech Stack
- AI Providers & Reasoning
- Agentic Tools
- Themes
- Keyboard Shortcuts
- Setup & Run
- Upgrade from v2
CodeDroid v3 is a fully-featured, AI-native desktop IDE that integrates 4 major AI providers, 11 autonomous agentic tools, a live visual edit mode, and Monaco Editor (the engine behind VS Code) — natively on Windows, macOS, and Linux.
| Core Engine | Description |
|---|---|
| 🧠 AI Copilot | 4 providers (Groq, Gemini, Claude, Ollama) with real-time streaming, 8 slash commands, and CoT reasoning. |
| 🌐 Live Visual Preview | Playwright-driven Chromium browser with click-to-edit DOM selectors and AI-driven source code patching. |
| 🛠️ Autonomous Auto-Fix | Closed-loop script debugger: runs shell tasks, auto-detects compile/runtime errors, writes minimal surgical fixes, and verifies. |
| ⚡ Monaco Editor | VS Code's core text engine, providing syntax highlighting, tabs, breadcrumbs, and full IntelliSense. |
| 🦀 Rust Addon | Native performance for ignores, ripgrep-style full-text searches, and libgit2-based file differences. |
| 🎨 15 Themes | 8 classic dark/light palettes + 6 exclusive high-contrast and neon themes (e.g. Void Black, Aurora Borealis). |
Run your web app directly inside the integrated browser view driven by Playwright. Toggle Edit Mode to hover and select any element on your page, type a prompt into the floating UI input, and let the AI patch the live DOM. When satisfied, click Save to write the modifications back to your local HTML/source file surgically, preserving all formatting and comments.
Runs compilation, test commands, or execution scripts directly in a dedicated tab. If a crash or exit code is detected, the error_detector parses the stderr traceback, maps it to a file, line, and column, prompts the LLM for a surgical fix, overwrites the file, and re-runs the task. Recurs up to 3 times or until the test suite passes.
Supports native reasoning models (DeepSeek-R1, Qwen-QwQ, Gemini Flash-Thinking) or injects specialized CoT instructions for standard models. Thinking streams are automatically parsed and rendered inside collapsible reasoning blocks in the AI Chat Panel.
codedroid/
├── src/ # TypeScript + React (Electron renderer)
│ ├── components/
│ │ ├── editor/ # Monaco Editor, tabs, breadcrumbs
│ │ ├── ai/ # AI Copilot panel (ask/plan/agent modes)
│ │ ├── sidebar/ # Files, Search, Git, Settings
│ │ └── terminal/ # xterm.js multi-tab terminal
│ ├── stores/ # Zustand global state persistence
│ ├── themes/ # 15 themes (8 classic + 1 light + 6 originals)
│ └── types/ # TypeScript declaration files
│
├── electron/ # Electron main process + IPC handlers
│ ├── main.js # Window shell, node-pty terminal tabs, Python boot
│ └── preload.js # Secure IPC bridge (contextBridge window.api)
│
├── python/ # FastAPI AI sidecar
│ ├── main.py # WebSocket chat routing, tool execution, auto-fix
│ ├── error_detector.py # Regex traceback/exit code classifier
│ ├── thinking_detector.py # CoT reasoning controller and token trimmer
│ ├── browser_agent.py # Playwright live preview controller
│ └── requirements.txt
│
└── crates/core/ # Rust native addon (napi-rs)
└── src/lib.rs # ignore-walking, full-text search, git2 diffs
| Layer | Technology |
|---|---|
| 🖥 Shell | Electron 29 |
| 🎨 UI | React 18 + Vite 5 |
| ✏️ Editor | Monaco Editor (VS Code's core engine) |
| 💻 Terminal | xterm.js (multi-tab node-pty stream) |
| 🗃 State | Zustand (Persisted via electron-store) |
| 🤖 AI Sidecar | FastAPI + httpx + Uvicorn (Python 3.10+) |
| 🔍 FS / Git / Search | Rust — napi-rs · ignore · regex · git2 |
| 🌐 Live Preview | Playwright (Chromium) |
All providers support real-time token streaming, agentic function-calling, and custom Chain-of-Thought (CoT) tracking.
| Provider | Streaming | Tool Use | Reasoning (CoT) |
|---|---|---|---|
| Groq | ✅ SSE | ✅ Native | ✅ Native / Injected |
| Gemini | ✅ Batch/Stream | ✅ Prompt-injected | ✅ Native / Injected |
| Claude | ✅ SSE | ✅ Native | ✅ Native (Budget config) |
| Ollama | ✅ Stream | ✅ Prompt-injected | ✅ Native / Injected |
Type these in the AI panel for instant context-aware actions:
| Command | Action |
|---|---|
/fix |
Fix bugs in selected code |
/explain |
Explain what the code does |
/refactor |
Refactor for cleanliness |
/tests |
Generate unit tests |
/docs |
Write documentation |
/optimize |
Optimize for performance |
/review |
Full code review |
/types |
Add TypeScript types |
The Python sidecar executes these tools autonomously on behalf of the AI inside Agent Mode:
read_file write_file create_file delete_file make_dir
list_files run_command run_python pip_install git_command web_fetch
VS Code Dark+ · One Dark Pro · Dracula · Monokai Pro · Nord · GitHub Dark · Catppuccin Mocha · Tokyo Night
GitHub Light
- Void Black: Pure black background with vibrant neon red accents.
- Aurora Borealis: Deep space navy with electric green and cyan highlights.
- Sandstorm: Warm desert browns with golden amber typography.
- Neon City: Cyberpunk purple with hot pink and cyan indicators.
- Sakura Dusk: Soft pinks on dark rose backgrounds.
- Glacier: Crisp ice blue and winter teal layout.
| Shortcut | Action |
|---|---|
Ctrl + S |
Save file |
Ctrl + Shift + S |
Save all files |
Ctrl + Shift + P |
Command palette |
Ctrl + B |
Toggle sidebar |
Ctrl + J |
Toggle terminal |
Ctrl + I |
Inline AI edit |
Ctrl + W |
Close tab |
Ctrl + Z / Ctrl + Y |
Undo / Redo |
- Node.js 18+
- Python 3.10+
- Rust + Cargo (optional — for native Rust addon)
npm installpip install -r python/requirements.txt(Optionally setup Playwright: pip install playwright && playwright install chromium)
cd crates/core
cargo build --releasenpm run devnpm run build| Feature | v2 · Flutter | v3 · TypeScript + Python + Rust |
|---|---|---|
| Editor | re_editor | Monaco Editor (VS Code core) |
| Search | Dart string scan | Rust regex (ripgrep-style) |
| AI providers | 3 | 4 (+ Claude) |
| Git diff | shell subprocess | libgit2 via Rust |
| Platform | Windows only | Windows + macOS + Linux |
| Themes | 13 | 15 (+ 6 originals) |
- khandev1211-cpu — Project Lead & Developer
- CodeDroid Repository — Main Project Repository
CodeDroid v3 — Built with ❤️ using TypeScript, Python & Rust
