AgentIDE

A real desktop IDE forked from VS Code — with an autonomous coding agent built in.

AgentIDE is not a web app. It is not a browser IDE. It is not a Next.js dashboard.

It is a modified VS Code distribution running on Electron, compiled to:

• AgentIDE.exe (Windows)
• AgentIDE.app (macOS)
• AgentIDE.AppImage (Linux)

---

What makes it different

Feature	VS Code	AgentIDE
Autonomous coding agent	❌	✅
Local LLM (Ollama/llama.cpp/vLLM)	❌	✅
Self-debugging loop	❌	✅
Iteration Viewer	❌	✅
Benchmark Runner (10 problems)	❌	✅
Execution Sandbox	❌	✅
Full trace system	❌	✅
Episode memory (SQLite)	❌	✅
Cloud models off by default	—	✅

---

Quick Start

Option A — Demo (no Electron)

Test the agent loop from the command line before building the full IDE:

./scripts/setup.ps1
./scripts/run-demo.ps1

You'll get an interactive prompt. Try:

Enter Goal: Build BFS in Python
Target File: app.py

Watch the daemon plan → code → review → execute → debug → repeat.

Option B — Full Desktop IDE

# 1. Install monorepo dependencies
./scripts/setup.ps1

# 2. Clone VS Code 1.90.2 and apply AgentIDE patches
./scripts/clone-and-patch.ps1

# 3. Compile everything
./scripts/build-fork.ps1

# 4. Launch in Electron dev mode
./scripts/run-dev.ps1

# 5. Build distributable
./scripts/package.ps1 -Platform win32 -Arch x64

---

Project Structure

AgentIDE/
├── vscode-fork/              VS Code-specific source modifications
│   └── src/vs/
│       ├── platform/         IAgentService, ILLMService, ITracesService, IExecutionService
│       └── workbench/
│           ├── contrib/agent/ Agent Panel, Iteration Viewer, Benchmark Runner
│           └── services/agentide/ Concrete service implementations
│
├── packages/
│   ├── agent-core/           AgentCoordinator + TCP Daemon
│   ├── local-llm/            Ollama/llama.cpp/vLLM discovery + routing
│   ├── execution-engine/     Python/Node sandboxed execution
│   ├── tool-runtime/         10 filesystem + shell agent tools
│   ├── memory/               SQLite episode + benchmark stores
│   ├── context-manager/      File context windowing
│   ├── test-runner/          pytest/jest integration
│   └── benchmark-suite/      10-problem evaluation suite
│
├── scripts/
│   ├── clone-and-patch.ps1  ← START HERE for full build
│   ├── build-fork.ps1
│   ├── run-dev.ps1
│   ├── run-demo.ps1         ← START HERE for demo
│   ├── package.ps1
│   └── setup.ps1
│
└── docs/
    ├── architecture.md       Full system diagram
    └── integration-guide.md  Manual VS Code integration steps

---

Agent Capabilities

The autonomous agent has 10 tools:

Tool	Description
read_file	Read any file in the workspace
write_file	Write / overwrite a file
edit_file	Apply SEARCH/REPLACE diff
search_workspace	Grep across the workspace
run_terminal	Execute shell commands (sandboxed)
run_tests	Run pytest or jest
git_diff	Get current git diff
create_file	Create new files
delete_file	Delete files
rename_file	Rename / move files

---

Local LLM Support

No cloud account required. No API key needed.

Provider	URL	Status
Ollama	http://localhost:11434	Auto-discovered
llama.cpp server	http://localhost:8080	Auto-discovered
vLLM	http://localhost:8000	Auto-discovered

Supported models: DeepSeek Coder, Qwen2.5 Coder, Codestral, Llama 3, Phi-3

To enable cloud models: Settings → AI → Allow Cloud Models

---

Benchmark Suite

10 built-in algorithm problems to measure agent performance:

1. FizzBuzz
2. Sorting (QuickSort)
3. Binary Search
4. Linked List Reversal
5. BFS Graph Traversal
6. DFS Tree Traversal
7. Dijkstra Shortest Path
8. REST API Controller
9. HTML Web Scraper
10. Multi-file Application

---

Keyboard Shortcuts

Action	Shortcut
Focus Agent Panel	Ctrl+Shift+A
Focus Iteration Viewer	Ctrl+Shift+I
Focus Benchmark Runner	Ctrl+Shift+B
Cancel Running Task	Ctrl+Escape

---

Architecture

See docs/architecture.md for the full system diagram.

---

License

MIT — same as VS Code.

Inspired by Cursor, Windsurf, Devin, Raycast, and Linear.