Claude Code

flowchart TD
  subgraph Entry["Entry Points"]
    MAIN["main.tsx"]
    SETUP["setup.ts"]
    EP["entrypoints/"]
  end
  subgraph UI["Terminal UI Layer"]
    INK["ink/ - Rendering Engine"]
    COMP["components/ - React Components"]
    SCREENS["screens/ - REPL, Doctor, Resume"]
    HOOKS["hooks/ - State Hooks"]
  end
  subgraph Core["Core Engine"]
    QE["query.ts - Query Engine"]
    TOOLS["tools/ - 40+ Tool Implementations"]
    CMDS["commands/ - 80+ Slash Commands"]
    TASKS["tasks/ - Background Task System"]
  end
  subgraph Services["Backend Services"]
    API["services/api/ - Anthropic API Client"]
    MCP["services/mcp/ - MCP Protocol"]
    LSP["services/lsp/ - Language Server"]
    COMPACT["services/compact/ - Compaction"]
    ANALYTICS["services/analytics/ - Telemetry"]
  end
  subgraph Infra["Infrastructure"]
    UTILS["utils/ - 300+ Utilities"]
    STATE["state/ - Zustand Store"]
    BRIDGE["bridge/ - Remote Control"]
    PERMS["types/ - Permissions & Types"]
  end

  MAIN --> SETUP --> SCREENS
  SCREENS --> HOOKS --> QE
  QE --> TOOLS
  QE --> CMDS
  QE --> API
  TOOLS --> UTILS
  CMDS --> UTILS
  COMP --> INK
  HOOKS --> STATE
  MCP --> TOOLS
  API --> BRIDGE
  TASKS --> QE
  LSP --> UTILS

sequenceDiagram
  participant User
  participant REPL as screens/REPL.tsx
  participant QE as query.ts
  participant API as services/api/
  participant Tools as tools/*
  participant FS as File System

  User->>REPL: Type prompt or /command
  REPL->>QE: Submit query with context
  QE->>QE: Build system prompt + memory
  QE->>API: Stream API request
  API-->>QE: Assistant response (text + tool_use)
  loop Tool Execution Loop
    QE->>Tools: Execute tool (bash, file_edit, grep...)
    Tools->>FS: Read/write files, run commands
    FS-->>Tools: Results
    Tools-->>QE: Tool result
    QE->>API: Continue with tool results
    API-->>QE: Next response
  end
  QE-->>REPL: Final response
  REPL-->>User: Render markdown + diffs

sequenceDiagram
  participant REPL as REPL (screens/)
  participant State as AppState (state/)
  participant QE as QueryEngine (query.ts)
  participant API as API Client (services/api/)
  participant Tools as Tool Registry (tools.ts)
  participant Bash as BashTool
  participant FE as FileEditTool
  participant Perms as Permissions (utils/)

  REPL->>State: setMessages(userInput)
  REPL->>QE: runQuery(messages, tools)
  QE->>API: stream(systemPrompt + messages)
  API-->>QE: tool_use: bash(command)
  QE->>Perms: checkPermission(bash, command)
  Perms-->>QE: allowed (or prompt user)
  QE->>Tools: findToolByName(Bash)
  Tools->>Bash: execute(command)
  Bash-->>QE: stdout + stderr
  QE->>API: tool_result(output)
  API-->>QE: tool_use: file_edit(path, diff)
  QE->>FE: execute(path, diff)
  FE-->>QE: success
  QE->>API: tool_result(applied)
  API-->>QE: text(Done! I edited the file.)
  QE->>State: appendAssistantMessage
  QE-->>REPL: render response