How tanbiralam/claude-code works
Claude Code is a terminal-based AI software-engineering assistant. Its central workflow is user input in the terminal UI, prompt processing and model querying, then presentation of responses and tool activity; permissions govern whether actions are allowed. The README also documents slash commands, MCP, persistent sessions and memory, agents, skills, and IDE/remote bridges. Sampled QueryEngine code confirms prompt processing, query dispatch, and session-storage flushing; session-storage excerpts confirm filesystem-backed transcripts. Several documented subsystems are represented by their supported directories or files because their implementation was not sampled.
Main entry points: App.tsx Terminal app · QueryEngine.ts Query engine · PromptInput.tsx Prompt input · sessionStorage.ts Session transcripts
Components 19
Terminal interaction
- Terminal app
src/components/App.tsx - Prompt input
src/components/PromptInput/PromptInput.tsx - Conversation display
src/components/Messages.tsx - Slash commands
src/commands.ts
Agent workflow
- Query engine
src/QueryEngine.ts - Tool definitions
src/Tool.ts - Tool approvals
src/components/permissions/FilePermissionDialog/usePermissionHandler.ts - Agent management
src/commands/agents/agents.tsx - Task management
src/hooks/useTasksV2.ts
Session and state
- Session transcripts
src/utils/sessionStorage.ts - Portable session reads
src/utils/sessionStoragePortable.ts - Session discovery
src/assistant/sessionDiscovery.ts - Session history
src/assistant/sessionHistory.ts - Persistent memory
src/commands/memory/memory.tsx
Integrations
- MCP management
src/components/mcp/index.ts - IDE bridge
src/bridge/bridgeMain.ts - Remote sessions
src/bridge/sessionRunner.ts
Other components
- Terminal user
- Anthropic API
Connections 14
- Terminal user → Terminal app: uses
- Terminal app → Prompt input: renders
- Terminal app → Conversation display: renders
- Terminal user → Slash commands: invokes
- Prompt input → Query engine: submits input
- Query engine → Anthropic API: queries model
- Query engine → Session transcripts: flushes session
- Session transcripts → Portable session reads: reads transcripts
- Terminal user → Tool approvals: responds to approval
- Terminal user → Agent management: manages agents
- Terminal user → Task management: manages tasks
- Terminal user → Persistent memory: manages memory
- Terminal user → MCP management: configures servers
- IDE bridge → Remote sessions: runs sessions