How whatevertogo/astrcodey works
AstrCode is a Rust-native AI coding agent with CLI, web, desktop, and protocol interfaces. A user submits a prompt through an interface; the server manages a session and schedules an agent turn, which builds context, calls a configured model, and executes tools before streaming results back. The repository also includes persistent sessions, extension and MCP integrations, web tools, memory, and evaluation capabilities. Relationships involving unsampled subsystems are included only where the README documents the capability; source-level wiring is cited where visible.
Main entry points: session_runtime_services.rs Session Runtime · app.rs Terminal UI · session_manager.rs Session Management · host_router.rs Extension Host
Components 24
User Interfaces
- CLI Entry
crates/astrcode-cli/src/main.rs - Terminal UI
crates/astrcode-cli/src/tui/app.rs - UI Event Handling
crates/astrcode-cli/src/tui/app/handle_event.rs - Keyboard Commands
crates/astrcode-cli/src/tui/keybinding.rs - CLI Transport
crates/astrcode-cli/src/transport.rs - Web Interface
frontend/src/App.tsx - Stream Rendering
crates/astrcode-cli/src/tui/streaming/controller.rs
Server and Sessions
- HTTP/SSE API
crates/astrcode-server/src/http/server.rs - Session Management
crates/astrcode-server/src/session_manager.rs - Server Event Bus
crates/astrcode-server/src/server_event_bus.rs - Turn Scheduler
crates/astrcode-server/src/turn_scheduler.rs - Child Sessions
crates/astrcode-server/src/child_session.rs
Agent Runtime
- Session Runtime
crates/astrcode-session/src/session_runtime_services.rs - Tool Execution
crates/astrcode-core/src/tool.rs - Prompt and Context
crates/astrcode-context/src/prompt_engine.rs - Context Compaction
crates/astrcode-session/src/compaction/pipeline.rs - Evaluation Framework
crates/astrcode-eval/src/runner.rs
Extensions and Providers
- LLM Providers
crates/astrcode-core/src/llm.rs - Extension Host
crates/astrcode-extensions/src/host_router.rs - MCP Integration
crates/astrcode-extension-mcp/src/http_client.rs - Memory Extension
crates/astrcode-extension-memory/src/pipeline.rs - Web Tools
crates/astrcode-extension-web-tools/src/lib.rs
Persistence
- Session Storage
crates/astrcode-storage/src/session_repo/store.rs
Other components
- User
Connections 26
- User → CLI Entry: starts agent
README.md - CLI Entry → Terminal UI: opens TUI
crates/astrcode-cli/src/main.rs - Terminal UI → Keyboard Commands: handles keys
crates/astrcode-cli/src/tui/mod.rs - Keyboard Commands → UI Event Handling: dispatches input
crates/astrcode-cli/src/tui/app/handle_event.rs - Terminal UI → UI Event Handling: applies updates
crates/astrcode-cli/src/tui/app.rs - Terminal UI → CLI Transport: sends commands
crates/astrcode-cli/src/tui/mod.rs - User → Web Interface: uses web app
README.md - Web Interface → HTTP/SSE API: connects via API
README.md - CLI Entry → HTTP/SSE API: starts server
crates/astrcode-cli/src/main.rs - HTTP/SSE API → Session Management: serves requests
crates/astrcode-server/src/http/server.rs - Session Management → Turn Scheduler: schedules turns
crates/astrcode-server/src/session_manager.rs - Session Management → Server Event Bus: publishes events
crates/astrcode-server/src/session_manager.rs - Session Management → Child Sessions: manages children
crates/astrcode-server/src/session_manager.rs - Turn Scheduler → Session Runtime: runs agent turn
- Session Runtime → Prompt and Context: builds prompt
- Session Runtime → LLM Providers: requests completion
README.md - Session Runtime → Tool Execution: executes tools
README.md - Session Runtime → Context Compaction: compacts context
README.md - Session Runtime → Session Storage: persists session
README.md - Server Event Bus → CLI Transport: streams updates
- CLI Transport → Stream Rendering: delivers deltas
- Session Runtime → Extension Host: invokes extensions
README.md - Extension Host → MCP Integration: routes MCP tools
README.md - Extension Host → Memory Extension: hosts memory
README.md - Extension Host → Web Tools: hosts web tools
README.md - User → Evaluation Framework: runs benchmarks
README.md