# vnaveen0/collection-claude-code-source-code architecture

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

- Interactive diagram: https://gitdiagram.com/vnaveen0/collection-claude-code-source-code
- Repository: https://github.com/vnaveen0/collection-claude-code-source-code

## Overview

This repository is a research collection: it archives Claude Code source and includes Python clean-room rewrites. In the TypeScript archive, the visible execution path is the query lifecycle engine, which invokes the agent query and flushes session state; tools and slash commands provide distinct user-facing capabilities. The tree also shows bridge, remote-session, task, and language-server subsystems, though their internal wiring is not sampled. The excerpts show session transcript persistence and portable transcript-reading utilities. The Python query engine is a separate rewrite, not a stage in the TypeScript flow.

Main entry points: [`claude-code-source-code/src/utils/sessionStorage.ts`](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/sessionStorage.ts) (Session storage), [`claude-code-source-code/src/QueryEngine.ts`](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/QueryEngine.ts) (Query lifecycle), [`claw-code/src/query_engine.py`](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/query_engine.py) (Rewrite query engine), [`claw-code/src/main.py`](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/main.py) (Rewrite entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ts["Claude Code archive"]
  node_engine["Query lifecycle<br/>[QueryEngine.ts]"]
  node_tools["Tool system<br/>[Tool.ts]"]
  node_commands["Slash commands<br/>[commands.ts]"]
  node_ui["Terminal interface<br/>[App.tsx]"]
end

subgraph group_persist["Session persistence"]
  node_storage[("Session storage<br/>[sessionStorage.ts]")]
  node_portable["Transcript reader"]
  node_state["Bootstrap state<br/>[state.ts]"]
  node_toolresults[("Tool result storage")]
end

subgraph group_integrations["Runtime integrations"]
  node_bridge["Bridge runtime"]
  node_remote["Remote sessions"]
  node_tasks["Task tracking<br/>[useTasksV2.ts]"]
  node_lsp["Language servers"]
end

subgraph group_rewrite["Python rewrite"]
  node_clawcli["Rewrite entry<br/>[main.py]"]
  node_clawengine["Rewrite query engine<br/>[query_engine.py]"]
  node_clawtools["Rewrite tools<br/>[tools.py]"]
  node_clawtasks["Rewrite tasks<br/>[tasks.py]"]
  node_clawspring["Clawspring runtime<br/>[clawspring.py]"]
end

node_user(("CLI user"))

node_user -.->|"submits query"| node_engine
node_engine -->|"flushes session"| node_storage
node_storage -->|"reads cwd state"| node_state
node_storage -->|"reads transcripts"| node_portable
node_clawcli -.->|"starts engine"| node_clawengine
node_clawengine -->|"builds tool backlog"| node_clawtools

click node_engine "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/QueryEngine.ts"
click node_tools "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/Tool.ts"
click node_commands "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/commands.ts"
click node_ui "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/components/App.tsx"
click node_bridge "https://github.com/vnaveen0/collection-claude-code-source-code/tree/main/claude-code-source-code/src/bridge"
click node_remote "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/remote/RemoteSessionManager.ts"
click node_tasks "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/hooks/useTasksV2.ts"
click node_lsp "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/services/lsp/LSPServerManager.ts"
click node_storage "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/sessionStorage.ts"
click node_portable "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/sessionStoragePortable.ts"
click node_state "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/bootstrap/state.ts"
click node_toolresults "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/toolResultStorage.ts"
click node_clawcli "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/main.py"
click node_clawengine "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/query_engine.py"
click node_clawtools "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/tools.py"
click node_clawtasks "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/tasks.py"
click node_clawspring "https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/clawspring/clawspring.py"

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_engine,node_tools,node_commands,node_ui,node_user toneBlue
class node_storage,node_portable,node_state,node_toolresults toneAmber
class node_bridge,node_remote,node_tasks,node_lsp toneMint
class node_clawcli,node_clawengine,node_clawtools,node_clawtasks,node_clawspring toneRose
```

## Components

### Claude Code archive

- [Query lifecycle](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/QueryEngine.ts): `claude-code-source-code/src/QueryEngine.ts`
- [Tool system](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/Tool.ts): `claude-code-source-code/src/Tool.ts`
- [Slash commands](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/commands.ts): `claude-code-source-code/src/commands.ts`
- [Terminal interface](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/components/App.tsx): `claude-code-source-code/src/components/App.tsx`

### Session persistence

- [Session storage](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/sessionStorage.ts): `claude-code-source-code/src/utils/sessionStorage.ts`
- [Transcript reader](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/sessionStoragePortable.ts): `claude-code-source-code/src/utils/sessionStoragePortable.ts`
- [Bootstrap state](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/bootstrap/state.ts): `claude-code-source-code/src/bootstrap/state.ts`
- [Tool result storage](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/utils/toolResultStorage.ts): `claude-code-source-code/src/utils/toolResultStorage.ts`

### Runtime integrations

- [Bridge runtime](https://github.com/vnaveen0/collection-claude-code-source-code/tree/main/claude-code-source-code/src/bridge): `claude-code-source-code/src/bridge`
- [Remote sessions](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/remote/RemoteSessionManager.ts): `claude-code-source-code/src/remote/RemoteSessionManager.ts`
- [Task tracking](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/hooks/useTasksV2.ts): `claude-code-source-code/src/hooks/useTasksV2.ts`
- [Language servers](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claude-code-source-code/src/services/lsp/LSPServerManager.ts): `claude-code-source-code/src/services/lsp/LSPServerManager.ts`

### Python rewrite

- [Rewrite entry](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/main.py): `claw-code/src/main.py`
- [Rewrite query engine](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/query_engine.py): `claw-code/src/query_engine.py`
- [Rewrite tools](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/tools.py): `claw-code/src/tools.py`
- [Rewrite tasks](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/claw-code/src/tasks.py): `claw-code/src/tasks.py`
- [Clawspring runtime](https://github.com/vnaveen0/collection-claude-code-source-code/blob/main/clawspring/clawspring.py): `clawspring/clawspring.py`

### Other components

- **CLI user**

## Connections

- CLI user → Query lifecycle: submits query
- Query lifecycle → Session storage: flushes session (evidence: `claude-code-source-code/src/QueryEngine.ts`)
- Session storage → Bootstrap state: reads cwd state (evidence: `claude-code-source-code/src/utils/sessionStorage.ts`)
- Session storage → Transcript reader: reads transcripts (evidence: `claude-code-source-code/src/utils/sessionStorage.ts`)
- Rewrite entry → Rewrite query engine: starts engine (evidence: `claw-code/src/main.py`)
- Rewrite query engine → Rewrite tools: builds tool backlog (evidence: `claw-code/src/query_engine.py`)