How friuns2/openclaude-android works
OpenClaude Mobile packages a coding-agent CLI for an embedded Linux environment, with an Android app as its advertised host. The main workflow is a user prompt entering the interactive REPL, passing through the query engine to an LLM, and invoking tools whose results feed the conversation. The README also documents MCP servers, multi-agent swarms, provider choices, session persistence, and headless gRPC operation. Several runtime links below are documented at capability level; unsampled implementation details are not inferred.
Main entry points: QueryEngine.ts Query engine · query.ts Query loop · REPL.tsx Interactive REPL · MCPConnectionManager.tsx MCP connections
Components 19
User interaction
- Interactive REPL
src/screens/REPL.tsx - Slash commands
src/commands.ts - gRPC server
src/grpc/server.ts
Agent runtime
- Query engine
src/QueryEngine.ts - Query loop
src/query.ts - Built-in tools
src/Tool.ts - Agent swarms
src/tools/AgentTool
Providers and tools
- Provider selection
src/components/ProviderManager.tsx - LLM APIs
- MCP connections
src/services/mcp/MCPConnectionManager.tsx - Plugin management
src/services/plugins/PluginInstallationManager.ts - Language servers
src/services/lsp/LSPServerManager.ts
State and services
- Session persistence
src/utils/sessionStorage.ts - Runtime state
src/bootstrap/state.ts - Configuration
src/utils/config.ts - Remote sessions
src/remote/RemoteSessionManager.ts
Other components
- User
- MCP servers
- gRPC client
Connections 18
- User → Interactive REPL: enters prompt
- Interactive REPL → Query engine: submits input
- Query engine → Query loop: runs query
src/QueryEngine.ts - Query engine → Session persistence: flushes session
src/QueryEngine.ts - Query loop → Built-in tools: dispatches tools
- Query loop → LLM APIs: streams requests
- Provider selection → LLM APIs: selects provider
- Query loop → Agent swarms: spawns agents
- Query loop → MCP connections: uses MCP tools
- MCP connections → MCP servers: connects servers
- Slash commands → Interactive REPL: provides commands
- gRPC server → Query engine: invokes engine
src/grpc/server.ts - gRPC client → gRPC server: connects headless
- Remote sessions → Session persistence: manages sessions
- Query engine → Runtime state: reads session state
src/QueryEngine.ts - Query engine → Configuration: reads configuration
src/QueryEngine.ts - Plugin management → MCP connections: supports MCP plugins
- Language servers → Query loop: assists coding