# ycbro/claude-code-haha architecture

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

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

## Overview

Claude-Code-YCbro is a local Claude Code-style terminal coding assistant, launched with a bundled Anthropic-to-DeepSeek proxy. The documented user flow is to provide an API key, choose a model and working directory, then use the Ink TUI to interact with the assistant; requests pass through the local proxy to DeepSeek, and tool calls let the assistant work in the project. The tree and README establish several feature areas, but source excerpts are limited, so links between unsampled subsystems are omitted unless the README documents them.

Main entry points: [`src/QueryEngine.ts`](https://github.com/ycbro/claude-code-haha/blob/main/src/QueryEngine.ts) (Query engine), [`exe-launcher.ts`](https://github.com/ycbro/claude-code-haha/blob/main/exe-launcher.ts) (EXE launcher), [`src/ink/components/App.tsx`](https://github.com/ycbro/claude-code-haha/blob/main/src/ink/components/App.tsx) (Ink terminal UI), [`src/commands.ts`](https://github.com/ycbro/claude-code-haha/blob/main/src/commands.ts) (Command registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and proxy"]
  node_launcher["EXE launcher<br/>[exe-launcher.ts]"]
  node_proxy["Protocol proxy<br/>[exe-launcher.ts]"]
end

subgraph group_assistant["Assistant runtime"]
  node_tui["Ink terminal UI<br/>[App.tsx]"]
  node_commands["Command registry<br/>[commands.ts]"]
  node_queryengine["Query engine<br/>[QueryEngine.ts]"]
  node_apiquery["API query flow<br/>[query.ts]"]
end

subgraph group_workspace["Project capabilities"]
  node_toolframework["Tool framework<br/>[Tool.ts]"]
  node_skills["Skills and commands<br/>[commands.ts]"]
  node_project["Project workspace"]
end

subgraph group_integrations["Extensions and state"]
  node_sessionstate["Session state<br/>[state.ts]"]
  node_transcripts[("Transcript storage<br/>[sessionStorage.ts]")]
  node_mcp["MCP services"]
  node_plugins["Plugin installation"]
end

node_user(("User"))
node_deepseek(("DeepSeek API"))

node_user -->|"configures"| node_launcher
node_launcher -->|"starts"| node_proxy
node_launcher -->|"opens"| node_tui
node_tui -->|"sends requests"| node_proxy
node_proxy -->|"converts and forwards"| node_deepseek
node_tui -.-> node_queryengine
node_queryengine -->|"uses query flow"| node_apiquery
node_queryengine -->|"loads commands"| node_commands
node_queryengine -->|"uses tools"| node_toolframework
node_queryengine -->|"uses session state"| node_sessionstate
node_sessionstate -->|"tracks sessions"| node_transcripts
node_toolframework -.->|"acts on"| node_project
node_user -.->|"configures"| node_mcp
node_user -.->|"manages"| node_plugins
node_commands -->|"includes"| node_skills

click node_launcher "https://github.com/ycbro/claude-code-haha/blob/main/exe-launcher.ts"
click node_proxy "https://github.com/ycbro/claude-code-haha/blob/main/exe-launcher.ts"
click node_tui "https://github.com/ycbro/claude-code-haha/blob/main/src/ink/components/App.tsx"
click node_commands "https://github.com/ycbro/claude-code-haha/blob/main/src/commands.ts"
click node_queryengine "https://github.com/ycbro/claude-code-haha/blob/main/src/QueryEngine.ts"
click node_apiquery "https://github.com/ycbro/claude-code-haha/blob/main/src/query.ts"
click node_toolframework "https://github.com/ycbro/claude-code-haha/blob/main/src/Tool.ts"
click node_sessionstate "https://github.com/ycbro/claude-code-haha/blob/main/src/bootstrap/state.ts"
click node_transcripts "https://github.com/ycbro/claude-code-haha/blob/main/src/utils/sessionStorage.ts"
click node_mcp "https://github.com/ycbro/claude-code-haha/blob/main/src/services/mcp/MCPConnectionManager.tsx"
click node_plugins "https://github.com/ycbro/claude-code-haha/blob/main/src/services/plugins/PluginInstallationManager.ts"
click node_skills "https://github.com/ycbro/claude-code-haha/blob/main/src/commands.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_launcher,node_proxy,node_user toneBlue
class node_tui,node_commands,node_queryengine,node_apiquery toneAmber
class node_toolframework,node_skills,node_project,node_deepseek toneMint
class node_sessionstate,node_transcripts,node_mcp,node_plugins toneRose
```

## Components

### Launch and proxy

- [EXE launcher](https://github.com/ycbro/claude-code-haha/blob/main/exe-launcher.ts): `exe-launcher.ts`
- [Protocol proxy](https://github.com/ycbro/claude-code-haha/blob/main/exe-launcher.ts): `exe-launcher.ts`

### Assistant runtime

- [Ink terminal UI](https://github.com/ycbro/claude-code-haha/blob/main/src/ink/components/App.tsx): `src/ink/components/App.tsx`
- [Command registry](https://github.com/ycbro/claude-code-haha/blob/main/src/commands.ts): `src/commands.ts`
- [Query engine](https://github.com/ycbro/claude-code-haha/blob/main/src/QueryEngine.ts): `src/QueryEngine.ts`
- [API query flow](https://github.com/ycbro/claude-code-haha/blob/main/src/query.ts): `src/query.ts`

### Project capabilities

- [Tool framework](https://github.com/ycbro/claude-code-haha/blob/main/src/Tool.ts): `src/Tool.ts`
- [Skills and commands](https://github.com/ycbro/claude-code-haha/blob/main/src/commands.ts): `src/commands.ts`
- **Project workspace**

### Extensions and state

- [Session state](https://github.com/ycbro/claude-code-haha/blob/main/src/bootstrap/state.ts): `src/bootstrap/state.ts`
- [Transcript storage](https://github.com/ycbro/claude-code-haha/blob/main/src/utils/sessionStorage.ts): `src/utils/sessionStorage.ts`
- [MCP services](https://github.com/ycbro/claude-code-haha/blob/main/src/services/mcp/MCPConnectionManager.tsx): `src/services/mcp/MCPConnectionManager.tsx`
- [Plugin installation](https://github.com/ycbro/claude-code-haha/blob/main/src/services/plugins/PluginInstallationManager.ts): `src/services/plugins/PluginInstallationManager.ts`

### Other components

- **User**
- **DeepSeek API**

## Connections

- User → EXE launcher: configures (evidence: `README.md`)
- EXE launcher → Protocol proxy: starts (evidence: `README.md`)
- EXE launcher → Ink terminal UI: opens (evidence: `README.md`)
- Ink terminal UI → Protocol proxy: sends requests (evidence: `README.md`)
- Protocol proxy → DeepSeek API: converts and forwards (evidence: `README.md`)
- Ink terminal UI → Query engine
- Query engine → API query flow: uses query flow (evidence: `src/QueryEngine.ts`)
- Query engine → Command registry: loads commands (evidence: `src/QueryEngine.ts`)
- Query engine → Tool framework: uses tools (evidence: `src/QueryEngine.ts`)
- Query engine → Session state: uses session state (evidence: `src/QueryEngine.ts`)
- Session state → Transcript storage: tracks sessions (evidence: `src/utils/sessionStorage.ts`)
- Tool framework → Project workspace: acts on
- User → MCP services: configures
- User → Plugin installation: manages
- Command registry → Skills and commands: includes (evidence: `src/commands.ts`)
