# chudickgumanoid/claude-code architecture

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

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

## Overview

Claude Code is a terminal-based software-engineering assistant. Its documented workflow starts with a user invoking the CLI or a slash command, proceeds through the query engine’s model/tool-call loop, and returns results through the terminal UI. The wider product includes permissions, session persistence, IDE bridging, remote sessions, plugins, skills, task management, memory, and MCP/LSP integrations. Some subsystems are represented by enclosing paths because their implementations were not excerpted; edges are limited to relationships stated in the README or visible in the source index.

Main entry points: [`src/QueryEngine.ts`](https://github.com/chudickgumanoid/claude-code/blob/main/src/QueryEngine.ts) (Query engine), [`src/Tool.ts`](https://github.com/chudickgumanoid/claude-code/blob/main/src/Tool.ts) (Tool system), [`src/services/api`](https://github.com/chudickgumanoid/claude-code/tree/main/src/services/api) (Anthropic API), [`src/server/directConnectManager.ts`](https://github.com/chudickgumanoid/claude-code/blob/main/src/server/directConnectManager.ts) (Direct connect)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["CLI interaction"]
  node_commands["Slash commands<br/>[commands.ts]"]
  node_terminal["Terminal UI<br/>[App.tsx]"]
end

subgraph group_agent["Agent runtime"]
  node_engine["Query engine<br/>[QueryEngine.ts]"]
  node_tooltypes["Tool system<br/>[Tool.ts]"]
  node_permissions["Tool permissions"]
  node_api["Anthropic API"]
end

subgraph group_state["State and memory"]
  node_config["Configuration<br/>[config.ts]"]
  node_session[("Session history<br/>[sessionStorage.ts]")]
  node_memory[("Persistent memory")]
  node_tasks["Task management"]
end

subgraph group_integrations["Integrations"]
  node_bridge["IDE bridge<br/>[bridgeMain.ts]"]
  node_mcp["MCP connections"]
  node_lsp["Language servers"]
  node_plugins["Plugin system"]
  node_skills["Skills"]
end

subgraph group_operations["Remote operations"]
  node_remote["Remote sessions"]
  node_server["Direct connect"]
end

node_user(("Engineer"))
node_external_model(("Claude service"))

node_user -->|"invokes"| node_commands
node_engine -->|"runs tool calls"| node_tooltypes
node_engine -->|"calls model"| node_api
node_api -->|"sends requests"| node_external_model
node_tooltypes -->|"checks invocation"| node_permissions
node_engine -->|"uses memory"| node_memory
node_engine -.->|"uses session history"| node_session
node_server -->|"manages sessions"| node_remote

click node_commands "https://github.com/chudickgumanoid/claude-code/blob/main/src/commands.ts"
click node_terminal "https://github.com/chudickgumanoid/claude-code/blob/main/src/ink/components/App.tsx"
click node_engine "https://github.com/chudickgumanoid/claude-code/blob/main/src/QueryEngine.ts"
click node_tooltypes "https://github.com/chudickgumanoid/claude-code/blob/main/src/Tool.ts"
click node_permissions "https://github.com/chudickgumanoid/claude-code/tree/main/src/hooks/toolPermission"
click node_api "https://github.com/chudickgumanoid/claude-code/tree/main/src/services/api"
click node_config "https://github.com/chudickgumanoid/claude-code/blob/main/src/utils/config.ts"
click node_session "https://github.com/chudickgumanoid/claude-code/blob/main/src/utils/sessionStorage.ts"
click node_memory "https://github.com/chudickgumanoid/claude-code/tree/main/src/memdir"
click node_tasks "https://github.com/chudickgumanoid/claude-code/tree/main/src/tasks"
click node_bridge "https://github.com/chudickgumanoid/claude-code/blob/main/src/bridge/bridgeMain.ts"
click node_mcp "https://github.com/chudickgumanoid/claude-code/blob/main/src/services/mcp/MCPConnectionManager.tsx"
click node_lsp "https://github.com/chudickgumanoid/claude-code/blob/main/src/services/lsp/LSPServerManager.ts"
click node_plugins "https://github.com/chudickgumanoid/claude-code/blob/main/src/services/plugins/PluginInstallationManager.ts"
click node_skills "https://github.com/chudickgumanoid/claude-code/tree/main/src/skills"
click node_remote "https://github.com/chudickgumanoid/claude-code/blob/main/src/remote/RemoteSessionManager.ts"
click node_server "https://github.com/chudickgumanoid/claude-code/blob/main/src/server/directConnectManager.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_commands,node_terminal toneBlue
class node_engine,node_tooltypes,node_permissions,node_api toneAmber
class node_config,node_session,node_memory,node_tasks toneMint
class node_bridge,node_mcp,node_lsp,node_plugins,node_skills toneRose
class node_remote,node_server,node_user,node_external_model toneIndigo
```

## Components

### CLI interaction

- [Slash commands](https://github.com/chudickgumanoid/claude-code/blob/main/src/commands.ts): `src/commands.ts`
- [Terminal UI](https://github.com/chudickgumanoid/claude-code/blob/main/src/ink/components/App.tsx): `src/ink/components/App.tsx`

### Agent runtime

- [Query engine](https://github.com/chudickgumanoid/claude-code/blob/main/src/QueryEngine.ts): `src/QueryEngine.ts`
- [Tool system](https://github.com/chudickgumanoid/claude-code/blob/main/src/Tool.ts): `src/Tool.ts`
- [Tool permissions](https://github.com/chudickgumanoid/claude-code/tree/main/src/hooks/toolPermission): `src/hooks/toolPermission`
- [Anthropic API](https://github.com/chudickgumanoid/claude-code/tree/main/src/services/api): `src/services/api`

### State and memory

- [Configuration](https://github.com/chudickgumanoid/claude-code/blob/main/src/utils/config.ts): `src/utils/config.ts`
- [Session history](https://github.com/chudickgumanoid/claude-code/blob/main/src/utils/sessionStorage.ts): `src/utils/sessionStorage.ts`
- [Persistent memory](https://github.com/chudickgumanoid/claude-code/tree/main/src/memdir): `src/memdir`
- [Task management](https://github.com/chudickgumanoid/claude-code/tree/main/src/tasks): `src/tasks`

### Integrations

- [IDE bridge](https://github.com/chudickgumanoid/claude-code/blob/main/src/bridge/bridgeMain.ts): `src/bridge/bridgeMain.ts`
- [MCP connections](https://github.com/chudickgumanoid/claude-code/blob/main/src/services/mcp/MCPConnectionManager.tsx): `src/services/mcp/MCPConnectionManager.tsx`
- [Language servers](https://github.com/chudickgumanoid/claude-code/blob/main/src/services/lsp/LSPServerManager.ts): `src/services/lsp/LSPServerManager.ts`
- [Plugin system](https://github.com/chudickgumanoid/claude-code/blob/main/src/services/plugins/PluginInstallationManager.ts): `src/services/plugins/PluginInstallationManager.ts`
- [Skills](https://github.com/chudickgumanoid/claude-code/tree/main/src/skills): `src/skills`

### Remote operations

- [Remote sessions](https://github.com/chudickgumanoid/claude-code/blob/main/src/remote/RemoteSessionManager.ts): `src/remote/RemoteSessionManager.ts`
- [Direct connect](https://github.com/chudickgumanoid/claude-code/blob/main/src/server/directConnectManager.ts): `src/server/directConnectManager.ts`

### Other components

- **Engineer**
- **Claude service**

## Connections

- Engineer → Slash commands: invokes (evidence: `README.md`)
- Query engine → Tool system: runs tool calls (evidence: `README.md`)
- Query engine → Anthropic API: calls model (evidence: `README.md`)
- Anthropic API → Claude service: sends requests (evidence: `README.md`)
- Tool system → Tool permissions: checks invocation (evidence: `README.md`)
- Query engine → Persistent memory: uses memory (evidence: `src/QueryEngine.ts`)
- Query engine → Session history: uses session history (evidence: `src/QueryEngine.ts`)
- Direct connect → Remote sessions: manages sessions (evidence: `src/server/directConnectManager.ts`)
