# mygu/claude-code-haha architecture

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

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

## Overview

Claude Code Haha is a local Claude Code-compatible terminal assistant, supporting interactive Ink TUI use and documented headless `--print` mode with configurable Anthropic-compatible APIs. The principal workflow is user input through the terminal interface into query/agent processing, which can use tools and return results; commands, MCP, plugins, and Skills add capabilities. Session persistence and shared runtime state support ongoing work. The README describes recovery mode, but its entrypoint is absent from the supplied tree. Some runtime wiring is unsampled, so uncertain links are omitted or marked unverified.

Main entry points: [`src/QueryEngine.ts`](https://github.com/mygu/claude-code-haha/blob/main/src/QueryEngine.ts) (Query engine), [`src/query.ts`](https://github.com/mygu/claude-code-haha/blob/main/src/query.ts) (Query lifecycle), [`src/ink.ts`](https://github.com/mygu/claude-code-haha/blob/main/src/ink.ts) (Ink terminal UI), [`src/utils/sessionStorage.ts`](https://github.com/mygu/claude-code-haha/blob/main/src/utils/sessionStorage.ts) (Session storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_terminal["Ink terminal UI<br/>[ink.ts]"]
end

subgraph group_agent["Agent runtime"]
  node_queryengine["Query engine<br/>[QueryEngine.ts]"]
  node_query["Query lifecycle<br/>[query.ts]"]
  node_toolcontract["Tool system<br/>[Tool.ts]"]
end

subgraph group_extensions["Extensions"]
  node_commands["Slash commands<br/>[commands.ts]"]
  node_mcp["MCP connections"]
  node_plugins["Plugin installation"]
  node_skills["Skills discovery<br/>[commands.ts]"]
end

subgraph group_state["State and persistence"]
  node_runtime["Runtime state<br/>[state.ts]"]
  node_sessions[("Session storage<br/>[sessionStorage.ts]")]
  node_portable["Transcript loading"]
end

node_user(("User"))
node_anthropic{{"Compatible API"}}

node_user -->|"enters prompt"| node_terminal
node_terminal -.->|"submits work"| node_queryengine
node_queryengine -->|"delegates query"| node_query
node_queryengine -->|"uses tools"| node_toolcontract
node_query -->|"uses tools"| node_toolcontract
node_query -->|"requests model"| node_anthropic
node_commands -->|"discovers skills"| node_skills
node_runtime -->|"tracks sessions"| node_sessions
node_sessions -->|"loads transcript"| node_portable

click node_terminal "https://github.com/mygu/claude-code-haha/blob/main/src/ink.ts"
click node_queryengine "https://github.com/mygu/claude-code-haha/blob/main/src/QueryEngine.ts"
click node_query "https://github.com/mygu/claude-code-haha/blob/main/src/query.ts"
click node_toolcontract "https://github.com/mygu/claude-code-haha/blob/main/src/Tool.ts"
click node_commands "https://github.com/mygu/claude-code-haha/blob/main/src/commands.ts"
click node_mcp "https://github.com/mygu/claude-code-haha/blob/main/src/services/mcp/MCPConnectionManager.tsx"
click node_plugins "https://github.com/mygu/claude-code-haha/blob/main/src/services/plugins/PluginInstallationManager.ts"
click node_skills "https://github.com/mygu/claude-code-haha/blob/main/src/commands.ts"
click node_runtime "https://github.com/mygu/claude-code-haha/blob/main/src/bootstrap/state.ts"
click node_sessions "https://github.com/mygu/claude-code-haha/blob/main/src/utils/sessionStorage.ts"
click node_portable "https://github.com/mygu/claude-code-haha/blob/main/src/utils/sessionStoragePortable.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_terminal,node_user toneBlue
class node_queryengine,node_query,node_toolcontract toneAmber
class node_commands,node_mcp,node_plugins,node_skills,node_anthropic toneMint
class node_runtime,node_sessions,node_portable toneRose
```

## Components

### User interaction

- [Ink terminal UI](https://github.com/mygu/claude-code-haha/blob/main/src/ink.ts): `src/ink.ts`

### Agent runtime

- [Query engine](https://github.com/mygu/claude-code-haha/blob/main/src/QueryEngine.ts): `src/QueryEngine.ts`
- [Query lifecycle](https://github.com/mygu/claude-code-haha/blob/main/src/query.ts): `src/query.ts`
- [Tool system](https://github.com/mygu/claude-code-haha/blob/main/src/Tool.ts): `src/Tool.ts`

### Extensions

- [Slash commands](https://github.com/mygu/claude-code-haha/blob/main/src/commands.ts): `src/commands.ts`
- [MCP connections](https://github.com/mygu/claude-code-haha/blob/main/src/services/mcp/MCPConnectionManager.tsx): `src/services/mcp/MCPConnectionManager.tsx`
- [Plugin installation](https://github.com/mygu/claude-code-haha/blob/main/src/services/plugins/PluginInstallationManager.ts): `src/services/plugins/PluginInstallationManager.ts`
- [Skills discovery](https://github.com/mygu/claude-code-haha/blob/main/src/commands.ts): `src/commands.ts`

### State and persistence

- [Runtime state](https://github.com/mygu/claude-code-haha/blob/main/src/bootstrap/state.ts): `src/bootstrap/state.ts`
- [Session storage](https://github.com/mygu/claude-code-haha/blob/main/src/utils/sessionStorage.ts): `src/utils/sessionStorage.ts`
- [Transcript loading](https://github.com/mygu/claude-code-haha/blob/main/src/utils/sessionStoragePortable.ts): `src/utils/sessionStoragePortable.ts`

### Other components

- **User**
- **Compatible API**

## Connections

- User → Ink terminal UI: enters prompt (evidence: `README.md`)
- Ink terminal UI → Query engine: submits work
- Query engine → Query lifecycle: delegates query (evidence: `src/QueryEngine.ts`)
- Query engine → Tool system: uses tools (evidence: `src/QueryEngine.ts`)
- Query lifecycle → Tool system: uses tools (evidence: `src/query.ts`)
- Query lifecycle → Compatible API: requests model (evidence: `README.md`)
- Slash commands → Skills discovery: discovers skills (evidence: `src/commands.ts`)
- Runtime state → Session storage: tracks sessions (evidence: `src/utils/sessionStorage.ts`)
- Session storage → Transcript loading: loads transcript (evidence: `src/utils/sessionStorage.ts`)
