# codeaashu/claude-code architecture

> Architecture diagram of the GitHub repository codeaashu/claude-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codeaashu/claude-code
- Repository: https://github.com/codeaashu/claude-code

## Overview

Claude Code is a terminal coding agent: a user submits prompts or slash commands, the runtime builds context, queries Claude, requests tool permissions, executes coding workflows, and persists results as sessions. The repository also includes an MCP source-exploration server. This map emphasizes documented capabilities and sampled call/data paths; several tool, command, and service implementations were not included in the excerpts, so their wiring is intentionally conservative.

Main entry points: [`src/QueryEngine.ts`](https://github.com/codeaashu/claude-code/blob/main/src/QueryEngine.ts) (Query Engine), [`src/commands.ts`](https://github.com/codeaashu/claude-code/blob/main/src/commands.ts) (Slash Commands), [`src/utils/sessionStorage.ts`](https://github.com/codeaashu/claude-code/blob/main/src/utils/sessionStorage.ts) (Session Storage), [`src/components/App.tsx`](https://github.com/codeaashu/claude-code/blob/main/src/components/App.tsx) (Terminal UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_app_ui["Terminal UI<br/>[App.tsx]"]
  node_prompt_input["Prompt Input<br/>[PromptInput.tsx]"]
end

subgraph group_runtime["Agent Runtime"]
  node_query_engine["Query Engine<br/>[QueryEngine.ts]"]
  node_tool_system["Agent Tools<br/>[Tool.ts]"]
  node_command_system["Slash Commands<br/>[commands.ts]"]
  node_git_workflows["Git Workflows<br/>[commit.ts]"]
  node_memory_commands["Memory Commands<br/>[memory.tsx]"]
end

subgraph group_state["State And Safety"]
  node_permissions["Permission Handler"]
  node_session_storage[("Session Storage<br/>[sessionStorage.ts]")]
  node_portable_transcripts["Transcript Scanner"]
  node_task_state["Task State<br/>[useTasksV2.ts]"]
  node_task_scheduler["Task Scheduler"]
end

subgraph group_integrations["Integrations"]
  node_mcp_integration["MCP Integration<br/>[index.ts]"]
  node_bridge["IDE Bridge<br/>[bridgeMain.ts]"]
  node_plugins["Plugin Options"]
  node_secure_storage[("Secure Credentials")]
end

subgraph group_explorer["Source Explorer"]
  node_explorer_server["Explorer Server<br/>[server.ts]"]
  node_explorer_http["Explorer HTTP<br/>[http.ts]"]
end

node_terminal_user(("Terminal User"))
node_mcp_client(("MCP Client"))
node_claude_api{{"Claude API"}}
node_mcp_servers{{"MCP Servers"}}
node_ide{{"IDE Host"}}
node_source_tree[("Source Tree")]

node_terminal_user -->|"uses"| node_app_ui
node_app_ui -->|"renders"| node_prompt_input
node_prompt_input -->|"submits input"| node_query_engine
node_query_engine -->|"loads commands"| node_command_system
node_query_engine -->|"passes tools"| node_tool_system
node_query_engine -->|"checks access"| node_permissions
node_query_engine -.->|"passes clients"| node_mcp_integration
node_query_engine -.->|"loads plugins"| node_plugins
node_query_engine -->|"queries model"| node_claude_api
node_command_system -->|"routes commands"| node_git_workflows
node_command_system -->|"routes commands"| node_memory_commands
node_permissions -->|"allows tool"| node_tool_system
node_query_engine -->|"flushes sessions"| node_session_storage
node_session_storage -->|"scans transcripts"| node_portable_transcripts
node_session_storage -->|"reads and writes"| node_source_tree
node_task_scheduler -->|"routes tasks"| node_task_state
node_task_state -->|"watches task files"| node_source_tree
node_mcp_integration -.->|"calls tools"| node_mcp_servers
node_bridge -.->|"connects sessions"| node_ide
node_plugins -->|"stores secrets"| node_secure_storage
node_secure_storage -.->|"uses local store"| node_source_tree
node_mcp_client -->|"requests exploration"| node_explorer_server
node_explorer_server -->|"serves tools"| node_explorer_http
node_explorer_http -->|"reads source"| node_source_tree

click node_app_ui "https://github.com/codeaashu/claude-code/blob/main/src/components/App.tsx"
click node_prompt_input "https://github.com/codeaashu/claude-code/blob/main/src/components/PromptInput/PromptInput.tsx"
click node_query_engine "https://github.com/codeaashu/claude-code/blob/main/src/QueryEngine.ts"
click node_tool_system "https://github.com/codeaashu/claude-code/blob/main/src/Tool.ts"
click node_command_system "https://github.com/codeaashu/claude-code/blob/main/src/commands.ts"
click node_git_workflows "https://github.com/codeaashu/claude-code/blob/main/src/commands/commit.ts"
click node_memory_commands "https://github.com/codeaashu/claude-code/blob/main/src/commands/memory/memory.tsx"
click node_permissions "https://github.com/codeaashu/claude-code/blob/main/src/components/permissions/FilePermissionDialog/usePermissionHandler.ts"
click node_session_storage "https://github.com/codeaashu/claude-code/blob/main/src/utils/sessionStorage.ts"
click node_portable_transcripts "https://github.com/codeaashu/claude-code/blob/main/src/utils/sessionStoragePortable.ts"
click node_task_state "https://github.com/codeaashu/claude-code/blob/main/src/hooks/useTasksV2.ts"
click node_task_scheduler "https://github.com/codeaashu/claude-code/blob/main/src/hooks/useScheduledTasks.ts"
click node_mcp_integration "https://github.com/codeaashu/claude-code/blob/main/src/components/mcp/index.ts"
click node_bridge "https://github.com/codeaashu/claude-code/blob/main/src/bridge/bridgeMain.ts"
click node_plugins "https://github.com/codeaashu/claude-code/blob/main/src/utils/plugins/pluginOptionsStorage.ts"
click node_secure_storage "https://github.com/codeaashu/claude-code/blob/main/src/utils/secureStorage/macOsKeychainStorage.ts"
click node_explorer_server "https://github.com/codeaashu/claude-code/blob/main/mcp-server/src/server.ts"
click node_explorer_http "https://github.com/codeaashu/claude-code/blob/main/mcp-server/src/http.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_ui,node_prompt_input,node_terminal_user,node_mcp_client toneBlue
class node_query_engine,node_tool_system,node_command_system,node_git_workflows,node_memory_commands,node_source_tree toneAmber
class node_permissions,node_session_storage,node_portable_transcripts,node_task_state,node_task_scheduler,node_claude_api,node_mcp_servers toneMint
class node_mcp_integration,node_bridge,node_plugins,node_secure_storage toneRose
class node_explorer_server,node_explorer_http,node_ide toneIndigo
```

## Components

### User Interface

- [Terminal UI](https://github.com/codeaashu/claude-code/blob/main/src/components/App.tsx): `src/components/App.tsx`
- [Prompt Input](https://github.com/codeaashu/claude-code/blob/main/src/components/PromptInput/PromptInput.tsx): `src/components/PromptInput/PromptInput.tsx`

### Agent Runtime

- [Query Engine](https://github.com/codeaashu/claude-code/blob/main/src/QueryEngine.ts): `src/QueryEngine.ts`
- [Agent Tools](https://github.com/codeaashu/claude-code/blob/main/src/Tool.ts): `src/Tool.ts`
- [Slash Commands](https://github.com/codeaashu/claude-code/blob/main/src/commands.ts): `src/commands.ts`
- [Git Workflows](https://github.com/codeaashu/claude-code/blob/main/src/commands/commit.ts): `src/commands/commit.ts`
- [Memory Commands](https://github.com/codeaashu/claude-code/blob/main/src/commands/memory/memory.tsx): `src/commands/memory/memory.tsx`

### State And Safety

- [Permission Handler](https://github.com/codeaashu/claude-code/blob/main/src/components/permissions/FilePermissionDialog/usePermissionHandler.ts): `src/components/permissions/FilePermissionDialog/usePermissionHandler.ts`
- [Session Storage](https://github.com/codeaashu/claude-code/blob/main/src/utils/sessionStorage.ts): `src/utils/sessionStorage.ts`
- [Transcript Scanner](https://github.com/codeaashu/claude-code/blob/main/src/utils/sessionStoragePortable.ts): `src/utils/sessionStoragePortable.ts`
- [Task State](https://github.com/codeaashu/claude-code/blob/main/src/hooks/useTasksV2.ts): `src/hooks/useTasksV2.ts`
- [Task Scheduler](https://github.com/codeaashu/claude-code/blob/main/src/hooks/useScheduledTasks.ts): `src/hooks/useScheduledTasks.ts`

### Integrations

- [MCP Integration](https://github.com/codeaashu/claude-code/blob/main/src/components/mcp/index.ts): `src/components/mcp/index.ts`
- [IDE Bridge](https://github.com/codeaashu/claude-code/blob/main/src/bridge/bridgeMain.ts): `src/bridge/bridgeMain.ts`
- [Plugin Options](https://github.com/codeaashu/claude-code/blob/main/src/utils/plugins/pluginOptionsStorage.ts): `src/utils/plugins/pluginOptionsStorage.ts`
- [Secure Credentials](https://github.com/codeaashu/claude-code/blob/main/src/utils/secureStorage/macOsKeychainStorage.ts): `src/utils/secureStorage/macOsKeychainStorage.ts`

### Source Explorer

- [Explorer Server](https://github.com/codeaashu/claude-code/blob/main/mcp-server/src/server.ts): `mcp-server/src/server.ts`
- [Explorer HTTP](https://github.com/codeaashu/claude-code/blob/main/mcp-server/src/http.ts): `mcp-server/src/http.ts`

### Other components

- **Terminal User**
- **MCP Client**
- **Claude API**
- **MCP Servers**
- **IDE Host**
- **Source Tree**

## Connections

- Terminal User → Terminal UI: uses
- Terminal UI → Prompt Input: renders
- Prompt Input → Query Engine: submits input
- Query Engine → Slash Commands: loads commands
- Query Engine → Agent Tools: passes tools
- Query Engine → Permission Handler: checks access
- Query Engine → MCP Integration: passes clients
- Query Engine → Plugin Options: loads plugins
- Query Engine → Claude API: queries model
- Slash Commands → Git Workflows: routes commands
- Slash Commands → Memory Commands: routes commands
- Permission Handler → Agent Tools: allows tool
- Query Engine → Session Storage: flushes sessions
- Session Storage → Transcript Scanner: scans transcripts
- Session Storage → Source Tree: reads and writes
- Task Scheduler → Task State: routes tasks
- Task State → Source Tree: watches task files
- MCP Integration → MCP Servers: calls tools
- IDE Bridge → IDE Host: connects sessions
- Plugin Options → Secure Credentials: stores secrets
- Secure Credentials → Source Tree: uses local store
- MCP Client → Explorer Server: requests exploration
- Explorer Server → Explorer HTTP: serves tools
- Explorer HTTP → Source Tree: reads source
