How chuhuan88/claude-code works
Claude Code is a terminal-based AI coding assistant. The principal workflow is a user submitting a prompt in the terminal, the assistant processing it through its query engine, and registered tools carrying out coding or other tasks subject to permissions; results return in the terminal. The repository also includes multi-agent work, MCP and plugin integrations, remote sessions, memory, and optional BUDDY and KAIROS features. The README documents these capabilities, but the supplied source excerpts do not establish all runtime call paths, so uncertain links are omitted.
Main entry points: Tool.ts Tool framework · QueryEngine.ts Query engine · App.tsx Ink terminal UI · MCPConnectionManager.tsx MCP connections
Components 19
Terminal interaction
- Ink terminal UI
ink/components/App.tsx - CLI commands
commands.ts
Assistant execution
- Query engine
QueryEngine.ts - Tool framework
Tool.ts - Permission controls
components/permissions/PermissionDialog.tsx - Agent tools
tools/AgentTool/agentColorManager.ts - Session state
bootstrap/state.ts - Session storage
utils/sessionStorage.ts - Settings
utils/settings/settings.ts
Integrations and remote
- MCP connections
services/mcp/MCPConnectionManager.tsx - Plugin management
services/plugins/PluginInstallationManager.ts - Remote sessions
remote/RemoteSessionManager.ts - Bridge sessions
bridge/bridgeMain.ts - Language servers
services/lsp/LSPServerManager.ts
Additional capabilities
- Memory commands
commands/memory/memory.tsx - BUDDY companion
buddy/companion.ts - KAIROS history
assistant/sessionHistory.ts - Remote planning
commands/ultraplan.tsx
Other components
- User
Connections 16
- User → Ink terminal UI: enters prompts
README.md - Ink terminal UI → CLI commands: invokes commands
commands.ts - Query engine → Tool framework: uses framework
QueryEngine.ts - Tool framework → Permission controls: permission checks
- Tool framework → Agent tools: coordinates agents
- Session state → Session storage: session data
utils/sessionStorage.ts - MCP connections → Tool framework: provides tools
services/mcp/MCPConnectionManager.tsx - Plugin management → Settings: stores options
- Remote sessions → Bridge sessions: remote execution
- User → Memory commands: manages memory
README.md - User → BUDDY companion: interacts with
README.md - KAIROS history → User: proactive updates
README.md - User → Remote planning: requests planning
README.md - User → MCP connections: configures servers
README.md - User → Plugin management: manages plugins
README.md - Query engine → Remote sessions: remote planning