How guess/claude_code works
Claude Code for Elixir is an SDK for running Claude Code CLI agents as OTP sessions and consuming their responses as Elixir streams. The principal workflow starts or queries a session, sends a prompt through the session process and CLI adapter, parses streamed JSON messages, and exposes results to the application. The README also documents in-process tools and hooks, session history and controls, subagents, structured output, distributed adapters, and plugin support. Several subsystem links are documented capabilities; unsampled implementation details are not inferred.
Main entry points: session.ex Session API · adapter.ex CLI adapters · parser.ex Stream parser · claude_code.ex SDK entry points
Components 21
Agent API
- SDK entry points
lib/claude_code.ex - Session API
lib/claude_code/session.ex - Stream helpers
lib/claude_code/stream.ex
Session Runtime
- Session process
lib/claude_code/session/server.ex - Session options
lib/claude_code/options.ex - CLI adapters
lib/claude_code/adapter.ex - Port adapter
lib/claude_code/adapter/port.ex - Remote adapter
lib/claude_code/adapter/node.ex
CLI Protocol
- Stream parser
lib/claude_code/cli/parser.ex - Message types
lib/claude_code/message/assistant_message.ex - Content blocks
lib/claude_code/content.ex
Agent Capabilities
- Hooks and permissions
lib/claude_code/hook.ex - In-process MCP tools
lib/claude_code/mcp/server.ex - MCP request router
lib/claude_code/mcp/router.ex - Subagent definitions
lib/claude_code/agent.ex
Session Operations
- Conversation history
lib/claude_code/history.ex - Remote sandboxes
lib/claude_code/sandbox.ex - Plugins
lib/claude_code/plugin.ex
Other components
- Elixir application
- Claude CLI
- Claude service
Connections 22
- Elixir application → SDK entry points: starts or queries
- SDK entry points → Session API: starts sessions
lib/claude_code.ex - Session API → Session process: manages session
- Session process → CLI adapters: dispatches queries
- CLI adapters → Port adapter: uses port transport
- CLI adapters → Remote adapter: supports remote
- Port adapter → Claude CLI: runs CLI
- Remote adapter → Claude CLI: offloads CLI
- Claude CLI → Stream parser: emits stream JSON
lib/claude_code/cli/parser.ex - Stream parser → Message types: parses messages
lib/claude_code/cli/parser.ex - Stream parser → Content blocks: parses blocks
lib/claude_code/cli/parser.ex - Session API → Stream helpers: streams responses
- Stream helpers → Elixir application: yields results
- Claude CLI → Hooks and permissions: requests callbacks
- Claude CLI → MCP request router: sends tool requests
- MCP request router → In-process MCP tools: dispatches tools
lib/claude_code/mcp/router.ex - Elixir application → In-process MCP tools: defines tools
- Elixir application → Hooks and permissions: configures hooks
- Elixir application → Subagent definitions: configures subagents
- Session API → Conversation history: reads history
- Elixir application → Remote sandboxes: uses distributed sessions
- Elixir application → Plugins: uses plugins