Open-source meta-agent orchestrator — one VS Code sidebar for every AI provider.
One sidebar. Every agent. One conversation.
Stop juggling Copilot in VS Code, Cursor in another IDE, Claude in a browser tab, and Devin in yet another panel. Todd of AIDLC keeps chat, file context, specs, and provider routing in a single interaction — so you stay in flow.
Today most teams use several AI tools. Each has its own window, login, and context. You re-attach the same files, re-explain the repo, and lose thread when you switch vendors.
Todd of AIDLC fixes that with one unified surface:
| Benefit | What you get |
|---|---|
| Single chat panel | Copilot, Claude, Cursor, Devin, and Kiro from one composer — switch with a pill or Auto routing. |
| Shared context | Attach files once (Add to Todd Context). The same chips go to every provider on the next message. |
| Spending dashboard | See requests, tokens in/out, and agent time per provider in one Spending tab (workspace-local). |
| Prompt optimization | Built-in pipeline trims history, dedupes messages, caps context files, and injects quality rules — fewer tokens, better answers on every provider. |
| One setup flow | API keys, MCP servers, workspace defaults, and usage stats — one configuration panel. |
| Spec-Driven Development | Todd specs (.toddspect/specs/) + spec-kit workflow (.toddspect/sdd/) — constitution → specify → plan → tasks → implement in the SDD view. |
| Same CLI under the hood | Extension and standalone CLI share routing, auth, and file I/O — no duplicate logic. |
→ Usage Guide · → User Manual · Wiki · Why Todd?
- Open VS Code →
Ctrl+Shift+X→ search "Todd Meta-Agent"
— or click: Install from Marketplace - Click Install → Reload Window.
- Click the Todd icon in the Activity Bar →
Ctrl+Shift+P→ Todd: Initialize Workspace.
- Download the latest
toddspect-vscode-*.vsixfrom Releases. Ctrl+Shift+P→ Extensions: Install from VSIX... → select the file → Reload Window.- Click the Todd icon in the Activity Bar →
Ctrl+Shift+P→ Todd: Initialize Workspace.
Full installation and first-use guide: USAGE.md
Todd of AIDLC is 100% open source under the MIT License.
Whether you fix a connector, improve docs, add a new provider, or share UX feedback — every contribution is welcome.
| How to help | Link |
|---|---|
| ⭐ Star the repo | github.com/nbsjunior/todd |
| 🐛 Report a bug | New Issue → Bug Report |
| 💡 Request a feature | New Issue → Feature Request |
| 🔧 Submit a PR | Read CONTRIBUTING.md and the GitFlow guide |
| 📖 Improve the Wiki | Edit wiki/ and run node scripts/publish-wiki.mjs |
| 🔒 Report a security issue | See SECURITY.md |
Quick dev setup:
git clone https://github.com/nbsjunior/todd.git
cd todd && npm install && npm run build
# Press F5 in VS Code (packages/extension) to launch the dev extensionSee CONTRIBUTING.md for conventions, the full connector checklist, and the PR checklist.
We use a simplified GitFlow:
| Branch | Purpose |
|---|---|
main |
Always releasable — every tag triggers a VSIX release |
develop |
Integration branch — features merge here |
feature/* |
One feature or fix per branch, created from develop |
release/* |
Release preparation (version bump, changelog) |
hotfix/* |
Critical fixes applied directly to main |
Full details: docs/gitflow.md
Todd of AIDLC is a VS Code extension acting as a Meta-Agent Orchestrator: you interact through one sidebar panel; Todd routes each request to the right agent using your provider choice (or Auto), your SDD specs, and the context you attached.
┌──────────────────────────────────────────────────────────┐
│ VS Code Sidebar │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────────┐ │
│ │ Chat View │ │ SDD View │ │ Agent Menu │ │
│ └──────┬───────┘ └──────┬───────┘ └───────┬───────┘ │
└─────────┼─────────────────┼──────────────────┼──────────┘
│ │ │
└─────────────────┴──────────────────┘
│ stdin/stdout JSON (IPC)
▼
┌─────────────────────────────────────────────────┐
│ CLI Daemon (Node.js) │
│ ┌────────────┐ ┌──────────┐ ┌───────────────┐ │
│ │ Context │ │ Spec │ │ Agent Router │ │
│ │ Builder │ │ Parser │ │ │ │
│ └────────────┘ └──────────┘ └───────┬───────┘ │
└──────────────────────────────────────┼─────────┘
│
┌────────────┬──────────────┬──────────┴──────────┐
▼ ▼ ▼ ▼
GitHub Copilot Devin Cursor AI Claude Code / Kiro
| Feature | Description |
|---|---|
| Spending & usage | Track calls, tokens (in/out), and duration per provider |
| Prompt optimization | Pre-route pipeline for efficiency (dedupe, history trim, file caps) and quality |
| Multi-provider chat | Copilot, Claude, Cursor, Devin, Kiro — one UI; switch with a pill or Auto routing |
| Context engineering | Right-click → Add to Todd Context; chips above composer; shared across providers |
| SDD view (spec-kit) | Full spec-kit pipeline: constitution → specify → plan → tasks → implement |
| Spec+Agent mode | Inject active specs + SDD artifacts as context before agent runs |
| Configuration Panel | Agents, MCP, workspace, and Spending — API keys and endpoints in one place |
| CLI Orchestrator | Node.js daemon: file I/O, spec parsing, agent routing (bundled in .vsix) |
| MCP Support | Connect Model Context Protocol servers (stdio or HTTP) |
| Auto-reconnect | CLI daemon restarts automatically if it crashes |
- Download
toddspect-vscode-*.vsixfrom Releases. Ctrl+Shift+P→ Extensions: Install from VSIX... → Reload.- Click Todd icon → Todd: Initialize Workspace.
git clone https://github.com/nbsjunior/todd.git
cd todd
npm install
npm run build:cli # build CLI daemon first
npm run watch # watch both packages
code packages/extension # open extension folder, then press F5Package as .vsix:
npm run package:vsix # builds + bundles CLI + vsce packagetodd/
├── packages/
│ ├── extension/ VS Code Extension (esbuild)
│ └── cli/ CLI Daemon (tsup/ESM)
├── docs/ Technical documentation
├── wiki/ GitHub Wiki source
├── scripts/ Build and publish helpers
├── .github/
│ ├── workflows/ CI (build + secret scan) + Release (VSIX)
│ ├── ISSUE_TEMPLATE/ Bug report & feature request forms
│ └── PULL_REQUEST_TEMPLATE.md
├── USAGE.md Full usage guide + MIT licence explanation
├── CONTRIBUTING.md Dev setup, conventions, connector checklist
├── SECURITY.md Vulnerability reporting and token handling policy
├── docs/gitflow.md Branch strategy and release process
└── LICENSE MIT
| Audience | Start here |
|---|---|
| New users | USAGE.md — install, setup, first chat, all features |
| User Manual (in-app) | docs/user-manual.md · Wiki: User Manual |
| Why Todd? | docs/why-todd-of-aidlc.md |
| GitHub Wiki | github.com/nbsjunior/todd/wiki |
| AI assistants | AGENTS.md → docs/ai-reference.md → docs/code-map.md |
| Developers | CONTRIBUTING.md · docs/architecture.md · docs/gitflow.md |
- Session persistence —
.toddspect/chat-session.json - Token and request usage tracking (Spending tab)
- Budget alerts and spending limits per provider
- Spec auto-discovery —
todd spec:discover - Multi-agent parallel execution —
todd agent:fanout - GitHub Actions integration
- Plugin marketplace (manifest preview)
- Web UI for remote instances —
todd web:serve - GitHub spec-kit SDD workflow in UI
- VS Code Marketplace publish
- Gemini / Mistral connectors
- Agent memory and long-context compression
- Per-spec token budgets
Tokens and API keys are stored exclusively in VS Code Secret Storage (system keychain) or environment variables — never in config files or logs.
To report a vulnerability: SECURITY.md
MIT — free to use, modify, and distribute. See LICENSE and the licence section in USAGE.md for plain-English details.
Copyright (c) 2026 Todd of AIDLC Contributors
If Todd saves you time, consider ⭐ starring the repo — it helps the project grow.