How codeaashu/claude-code works
Claude Code is a terminal coding agent: a user submits prompts or slash commands, the runtime builds context, queries Claude, requests tool permissions, executes coding workflows, and persists results as sessions. The repository also includes an MCP source-exploration server. This map emphasizes documented capabilities and sampled call/data paths; several tool, command, and service implementations were not included in the excerpts, so their wiring is intentionally conservative.
Main entry points: QueryEngine.ts Query Engine · commands.ts Slash Commands · sessionStorage.ts Session Storage · App.tsx Terminal UI
Components 24
User Interface
- Terminal UI
src/components/App.tsx - Prompt Input
src/components/PromptInput/PromptInput.tsx
Agent Runtime
- Query Engine
src/QueryEngine.ts - Agent Tools
src/Tool.ts - Slash Commands
src/commands.ts - Git Workflows
src/commands/commit.ts - Memory Commands
src/commands/memory/memory.tsx
State And Safety
- Permission Handler
src/components/permissions/FilePermissionDialog/usePermissionHandler.ts - Session Storage
src/utils/sessionStorage.ts - Transcript Scanner
src/utils/sessionStoragePortable.ts - Task State
src/hooks/useTasksV2.ts - Task Scheduler
src/hooks/useScheduledTasks.ts
Integrations
- MCP Integration
src/components/mcp/index.ts - IDE Bridge
src/bridge/bridgeMain.ts - Plugin Options
src/utils/plugins/pluginOptionsStorage.ts - Secure Credentials
src/utils/secureStorage/macOsKeychainStorage.ts
Source Explorer
- Explorer Server
mcp-server/src/server.ts - Explorer HTTP
mcp-server/src/http.ts
Other components
- Terminal User
- MCP Client
- Claude API
- MCP Servers
- IDE Host
- Source Tree
Connections 24
- Terminal User → Terminal UI: uses
- Terminal UI → Prompt Input: renders
- Prompt Input → Query Engine: submits input
- Query Engine → Slash Commands: loads commands
- Query Engine → Agent Tools: passes tools
- Query Engine → Permission Handler: checks access
- Query Engine → MCP Integration: passes clients
- Query Engine → Plugin Options: loads plugins
- Query Engine → Claude API: queries model
- Slash Commands → Git Workflows: routes commands
- Slash Commands → Memory Commands: routes commands
- Permission Handler → Agent Tools: allows tool
- Query Engine → Session Storage: flushes sessions
- Session Storage → Transcript Scanner: scans transcripts
- Session Storage → Source Tree: reads and writes
- Task Scheduler → Task State: routes tasks
- Task State → Source Tree: watches task files
- MCP Integration → MCP Servers: calls tools
- IDE Bridge → IDE Host: connects sessions
- Plugin Options → Secure Credentials: stores secrets
- Secure Credentials → Source Tree: uses local store
- MCP Client → Explorer Server: requests exploration
- Explorer Server → Explorer HTTP: serves tools
- Explorer HTTP → Source Tree: reads source