Ouroboros AI VS Code Extension
Structured AI agent workflow with spec-driven development
Features
- LM Tools Integration: 6 custom tools for Copilot/AI agents to interact with users
- Sidebar UI: Visual workflow progress, pending requests, agent hierarchy, and history
- Dual-Mode Compatibility: Works with both Extension mode and TUI mode
- Spec-Driven Development: Structured approach to feature development
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "Ouroboros AI"
- Click Install
From VSIX
code --install-extension ouroboros-ai-x.x.x.vsix
Quick Start
- Open a workspace folder
- Run command:
Ouroboros: Initialize Project
- Start using Copilot with Ouroboros agents
The extension provides 13 tools that AI agents can use:
| Tool |
Purpose |
ouroborosai_ask |
Get user input (task, question, feature description) |
ouroborosai_menu |
Present multiple choice options |
ouroborosai_confirm |
Get yes/no confirmation |
ouroborosai_plan_review |
Present plan/document for approval |
ouroborosai_agent_handoff |
Notify agent level transitions |
| Tool |
Purpose |
ouroborosai_graph_digest |
Compact codebase overview (~500 tokens) |
ouroborosai_graph_issues |
Code quality issues with evidence and fixes |
ouroborosai_graph_impact |
Change impact analysis with risk assessment |
ouroborosai_graph_path |
Find dependency paths between modules |
ouroborosai_graph_module |
Get detailed module information |
ouroborosai_graph_annotations |
Manage manual graph annotations |
ouroborosai_graph_cycles |
Detect circular dependencies |
ouroborosai_graph_layers |
Check architectural layer violations |
All Code Graph tools return responses in a unified envelope format with:
success flag, tool name, version, requestId, generatedAtworkspace context (root, repoName)result (business output)meta (approxTokens, truncated, limits, nextQuerySuggestion)
Commands
| Command |
Description |
Ouroboros: Initialize Project |
Set up Ouroboros in current workspace |
Ouroboros: Open Sidebar |
Focus the Ouroboros sidebar |
Ouroboros: Clear History |
Clear interaction history |
Ouroboros: Cancel Current Request |
Cancel pending request |
Configuration
| Setting |
Default |
Description |
ouroboros.executionMode |
task-by-task |
Default execution mode |
ouroboros.showStatusBar |
true |
Show status in status bar |
ouroboros.historyLimit |
100 |
Max history entries |
Execution Modes
- task-by-task: Confirm each task before execution
- phase-by-phase: Confirm each phase before execution
- auto-run: Run all tasks automatically
Requirements
- VS Code 1.95.0 or higher
- GitHub Copilot (recommended)
Development
Building
cd extension
npm install
npm run compile
Testing
# Run extension in development mode
npm run watch
# Then press F5 in VS Code to launch Extension Development Host
Packaging
npm run package
npx vsce package --no-dependencies
License
MIT
The Serpent Consumes Its Tail. The Loop Never Ends.
| |
