AtlasMind
A multi-agent AI orchestrator that lives inside VS Code.
Route tasks across models, maintain long-term project memory, and let specialised agents handle the work — without leaving your editor.
Overview ·
Quick Start ·
Workflows ·
Comparison ·
Docs ·
Support ·
Changelog
What is AtlasMind?
AtlasMind turns VS Code into a full agentic development environment. Instead of a single chatbot, you get an orchestrator that picks the right agent, the right model, and the right tools for every task — then tracks cost and remembers decisions across sessions.
- Multi-agent — define specialised agents (architect, refactorer, tester, etc.) and let the orchestrator route work automatically.
- Multi-provider model routing — Claude, GPT, Gemini, DeepSeek, Mistral, z.ai, Copilot, or a local model. Budget and speed preferences steer selection.
- 26 built-in skills — file read/write/edit, git operations, diagnostics, code navigation, test running, web fetch, and more. Extend with custom skills or MCP servers.
- Long-term project memory (SSOT) — decisions, architecture notes, domain knowledge, and lessons learned persist in a structured memory folder that agents can query and update.
- Project planner — decompose goals into parallel subtasks, preview impact, gate execution with approvals, and review results.
- Cost tracking — real-time per-session spend with budget guardrails.
| At a Glance |
|
| Best for |
VS Code users who want agentic workflows without leaving the editor |
| Core strengths |
Multi-agent orchestration, model routing, project memory, approval-gated execution |
| Learn next |
Quick Start, Core Workflows, Documentation |
Quick Start
Prerequisites: VS Code >= 1.95.0 · Node.js >= 18
npm install
npm run compile
For a local installable extension package, use npm run package:vsix.
AtlasMind has runtime dependencies, so do not package or publish with --no-dependencies unless those dependencies are bundled into out/ first.
Press F5 to launch the Extension Development Host, then type @atlas in the chat panel.
Recommended first steps:
- Open AtlasMind: Manage Model Providers and add at least one provider.
The Local provider can also be configured here for Ollama, LM Studio, Open WebUI, or another OpenAI-compatible local endpoint.
- If you want to use the Copilot provider, install the
GitHub Copilot Chat extension and sign in.
- Run
/bootstrap for a new project or /import for an existing one.
- Try
@atlas /project on a small task to see planning, approvals, and execution end to end.
Useful command palette shortcuts:
- AtlasMind: Getting Started opens the onboarding walkthrough directly.
- AtlasMind: Manage Model Providers opens provider setup.
- AtlasMind: Manage Agents opens the custom agent editor.
- The Models sidebar now exposes inline enable/disable, configure, info, and assign-to-agent actions for provider and model rows. Status is shown with colored icons, partially enabled providers get an extra bracketed warning marker, and unconfigured providers are grouped at the bottom while keeping their child models hidden until credentials are set.
For setup details, provider notes, and development workflows, see docs/development.md, docs/model-routing.md, and wiki/Getting-Started.md.
Core Workflows
| Workflow |
What it covers |
Read more |
| Chat and slash commands |
Direct work through @atlas, plus /bootstrap, /import, /project, /runs, /agents, /skills, /memory, /cost, /voice, and /vision |
wiki/Chat-Commands.md |
| Model routing |
Budget, speed, capability, provider-health-aware model selection, and persistent per-provider/per-model availability controls |
docs/model-routing.md |
| Agents, skills, and MCP |
Custom agents, built-in skills, imported skills, and MCP server extensions |
docs/agents-and-skills.md |
| Project memory |
SSOT storage for architecture notes, decisions, and reusable project context |
docs/ssot-memory.md |
| Safety controls |
Approval gating, sandboxing, memory scanning, and tool/webhook safety |
SECURITY.md |
How it Compares
| Capability |
AtlasMind |
Claude Code |
Cursor |
GitHub Copilot |
Aider |
Open Hands |
| Runs inside VS Code |
✅ |
✅ |
✅ (fork) |
✅ |
❌ |
❌ |
| Multiple AI agents |
✅ |
✅ |
❌ |
⚠️ |
❌ |
✅ |
| Multi-provider routing |
✅ |
⚠️ |
✅ |
⚠️ |
✅ |
✅ |
| Long-term project memory |
✅ |
⚠️ |
❌ |
⚠️ |
❌ |
❌ |
| Approval gating and checkpoints |
✅ |
✅ |
✅ |
⚠️ |
✅ |
❌ |
| Cost-aware planning |
✅ |
❌ |
❌ |
❌ |
❌ |
❌ |
Note: Capability comparisons are approximate and reflect the state of each tool as of early 2026. Check each project's docs for the latest.
The full comparison matrix and product notes live in wiki/Comparison.md.
Support AtlasMind
AtlasMind remains fully open source under the MIT license. There is no paywall, no feature gating, and no commercial-only edition.
If AtlasMind saves you time or helps your team, you can support ongoing development through GitHub Sponsors.
Sponsorship details, suggested levels, and team-oriented support notes live in wiki/Funding-and-Sponsorship.md.
Configuration
AtlasMind is configured through VS Code settings (atlasmind.*). The most important settings to start with are:
| Setting |
Default |
What it controls |
budgetMode |
balanced |
Model cost preference: cheap · balanced · expensive · auto |
speedMode |
balanced |
Model speed preference: fast · balanced · considered · auto |
dailyCostLimitUsd |
0 |
Daily spend cap in USD. 0 disables it; AtlasMind warns at 80% and blocks new requests at the limit |
toolApprovalMode |
ask-on-write |
When to prompt before tool execution |
ssotPath |
project_memory |
Where project memory lives |
See docs/configuration.md for the full settings reference.
Project Structure
The repository is organized around a few major areas:
src/core — orchestration, planning, routing, checkpoints, cost tracking
src/chat, src/views, src/voice — chat and UI surfaces
src/providers, src/skills, src/mcp — model adapters and execution tools
src/memory, src/bootstrap — SSOT memory and project onboarding/import flows
tests, docs, wiki — automated verification and deeper documentation
See docs/architecture.md for the full dependency graph and docs/development.md for the complete project structure.
Documentation
Use the README for the short overview, then go deeper as needed:
Contributing
See CONTRIBUTING.md for dev setup, conventions, and how to add providers, agents, or skills.
License
MIT — see LICENSE
| |