How zoo-code-org/zoo-code works
Zoo Code is a VS Code AI coding assistant: users submit coding or question tasks, choose a mode and model, and receive streamed answers or tool-driven workspace changes. The main product path spans the extension UI, task orchestration, provider adapters, and editor/workspace capabilities. Separate branches cover codebase search, skills and modes, marketplace extensions, MCP connections, cloud services, and the standalone CLI. Several links are documented or inferred from the product description because the task and webview orchestration sources were not sampled; those links are marked unverified.
Main entry points: ClineProvider.ts Task Orchestration · index.ts VS Code Extension · openrouter.ts Provider Adapters · App.tsx Chat Webview
Components 21
User Interaction
- VS Code Extension
src/activate/index.ts - Chat Webview
webview-ui/src/App.tsx - Webview Messages
src/core/webview/webviewMessageHandler.ts - CLI Agent
apps/cli/src/agent/agent-state.ts
Task Runtime
- Task Orchestration
src/core/webview/ClineProvider.ts - Prompt Assembly
src/core/prompts/sections/custom-instructions.ts - Assistant Tool Calls
src/core/assistant-message/presentAssistantMessage.ts - Task History
src/core/task-persistence/TaskHistoryStore.ts
Model Access
- Provider API
src/api/index.ts - Provider Adapters
src/api/providers/openrouter.ts - Model Catalog
src/api/providers/fetchers/modelCache.ts - Stream Transforms
src/api/transform/stream.ts
Workspace Features
- Semantic Code Search
src/services/code-index/manager.ts - Custom Modes
src/core/config/CustomModesManager.ts - Skills
src/services/skills/SkillsManager.ts - Marketplace
src/services/marketplace/MarketplaceManager.ts
Extensions & Services
- MCP OAuth
src/services/mcp/McpOAuthClientProvider.ts - Cloud Sign-In
packages/cloud/src/WebAuthService.ts
Other components
- Developer
- Model Service
- MCP Server
Connections 21
- Developer → VS Code Extension: starts work
README.md - VS Code Extension → Chat Webview: opens chat
- Chat Webview → Webview Messages: sends messages
- Webview Messages → Task Orchestration: dispatches task
- Task Orchestration → Prompt Assembly: assembles prompt
- Task Orchestration → Provider API: requests completion
- Provider API → Provider Adapters: selects provider
src/api/index.ts - Provider Adapters → Model Catalog: loads models
src/api/providers/openrouter.ts - Provider Adapters → Stream Transforms: emits chunks
src/api/providers/openrouter.ts - Provider Adapters → Model Service: calls model
README.md - Task Orchestration → Assistant Tool Calls: handles response
- Assistant Tool Calls → Task Orchestration: requests actions
- Task Orchestration → Task History: persists task
- Task Orchestration → Semantic Code Search: searches codebase
README.md - Task Orchestration → Custom Modes: applies mode
README.md - Task Orchestration → Skills: uses skills
README.md - Task Orchestration → MCP OAuth: authenticates MCP
- MCP OAuth → MCP Server: authorizes access
README.md - VS Code Extension → Marketplace: manages extensions
- VS Code Extension → Cloud Sign-In: signs in
- Developer → CLI Agent: runs CLI