# kodu-ai/claude-coder architecture

> Architecture diagram of the GitHub repository kodu-ai/claude-coder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kodu-ai/claude-coder
- Repository: https://github.com/kodu-ai/claude-coder

## Overview

##### Main System Components

a) Extension Core (VS Code Integration Layer)
- Extension Host
- WebView UI
- Command System
- State Management

b) Agent System
- Agent Core
- Task Executor
- Tool System
- Prompt Management

c) Integration Services
- LSP Integration
- Terminal Integration
- Editor Integration
- File System Integration

d) API Layer
- API Handlers
- Provider Integration (Claude/Kodu)
- Conversation Management

##### Component Relationships

**[VS Code Editor] <---> [Extension Host]**
- ^                     ^

**[WebView UI] <-----> [State Management]**
- ^

**[Agent System] <---> [Tool System]**
- ^                  ^

**[Task Executor] <---> [Integration Services]**
- ^

**[API Layer] <---> [External Services]**

##### Detailed Component Breakdown

For each major component, include:

a) Extension Core:
- WebView UI Manager
- Extension State Manager
- Command Registration
- Event Handlers

b) Agent System:
- Prompt Management
- Tool Execution
- State Management
- Hook System
- Task Planning

c) Integration Services:
- Symbol Explorer
- Terminal Manager
- Code Parser
- File System Operations

d) Tool System:
- File Operations
- Git Integration
- Command Execution
- Web Search
- Screenshot Capture

##### Data Flow Indicators

- Double lines: File system operations

##### Deployment View

How the extension integrates with:
- VS Code marketplace
- Authentication services
- External APIs
- File system

This system design should help developers understand both the high-level architecture and the detailed interactions between components, making it easier to maintain and extend the extension.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph VSCode
        EH["Extension Host"]
        WUI["WebView UI"]
        CS["Command System"]
        SM["State Management"]
    end

    subgraph AgentSystem
        AC["Agent Core"]
        TE["Task Executor"]
        TS["Tool System"]
        PM["Prompt Management"]
    end

    subgraph IntegrationServices
        LSP["LSP Integration"]
        TI["Terminal Integration"]
        EI["Editor Integration"]
        FSI["File System Integration"]
    end

    subgraph APILayer
        AH["API Handlers"]
        PI["Provider Integration"]
        CM["Conversation Management"]
    end

    subgraph StateManagement
        ES["Extension State"]
        GS["Global State"]
        AS["API State"]
        TS2["Task State"]
    end

    subgraph ToolSystem
        TEX["Tool Executor"]
        TSC["Tool Schema"]
        TR["Tool Runners"]
    end

    %% Core relationships
    EH <--> WUI
    EH <--> CS
    EH <--> SM
    SM <--> StateManagement
    
    %% Agent System relationships
    AC <--> TE
    AC <--> TS
    AC <--> PM
    
    %% Integration relationships
    TE <--> IntegrationServices
    TS <--> IntegrationServices
    
    %% API Layer relationships
    APILayer <--> AgentSystem
    APILayer <--> StateManagement

    %% Tool System relationships
    TS <--> ToolSystem
    
    %% Styling
    classDef core fill:#blue
    classDef agent fill:#green
    classDef integration fill:#purple
    classDef api fill:#gray
    classDef state fill:#orange
    classDef tool fill:#yellow

    class EH,WUI,CS,SM core
    class AC,TE,TS,PM agent
    class LSP,TI,EI,FSI integration
    class AH,PI,CM api
    class ES,GS,AS,TS2 state
    class TEX,TSC,TR tool

    %% Click events
    click EH "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/extension.ts"
    click WUI "https://github.com/kodu-ai/claude-coder/tree/main/extension/webview-ui-vite/"
    click CS "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/providers/extension-provider.ts"
    click SM "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/providers/state/"
    click AC "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/"
    click TE "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/task-executor/"
    click TS "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/tools/"
    click PM "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/prompts/"
    click LSP "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/integrations/lsp/"
    click TI "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/integrations/terminal/"
    click EI "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/integrations/editor/"
    click FSI "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/utils/fs.ts"
    click AH "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/api/api-handler.ts"
    click PI "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/api/providers/"
    click CM "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/api/conversation-utils.ts"
    click ES "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/providers/state/extension-state-manager.ts"
    click GS "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/providers/state/global-state-manager.ts"
    click AS "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/providers/state/api-manager.ts"
    click TS2 "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/providers/state/task-manager.ts"
    click TEX "https://github.com/kodu-ai/claude-coder/blob/main/extension/src/agent/v1/tools/tool-executor.ts"
    click TSC "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/tools/schema/"
    click TR "https://github.com/kodu-ai/claude-coder/tree/main/extension/src/agent/v1/tools/runners/"
```
