How seanaxxx/qodex works
Qodex is an on-device Android coding agent: a user chats in the Compose app, the host starts and provisions an embedded Node.js Bionic runtime, and framed stdio RPC carries work to the agent engine. The engine can stream model output, use tools against a workspace, and return results to the UI; the README also documents credentials, background execution, and optional elevated shell access. Edges rely on the README or shown source references; unsampled subsystems are represented without speculative internal call chains.
Main entry points: EngineProcess.kt Engine process · qodex-cli Agent engine · Provisioner.kt Runtime provisioning · workspace-hook-review-controller.ts Hook review
Components 24
Android host
- Compose interface
android/app/src/main/java/com/qodex/app/ui - App state
android/app/src/main/java/com/qodex/app/state/QodexAppViewModel.kt - RPC client
android/app/src/main/java/com/qodex/app/rpc/QodexRpcClient.kt - Engine process
android/app/src/main/java/com/qodex/app/runtime/EngineProcess.kt - Runtime provisioning
android/app/src/main/java/com/qodex/app/runtime/Provisioner.kt - Bionic environment
android/app/src/main/java/com/qodex/app/runtime/BionicEnv.kt - Runtime status
android/app/src/main/java/com/qodex/app/runtime/RuntimeBus.kt - File logging
android/app/src/main/java/com/qodex/app/utils/FileLogger.kt - Background service
android/app/src/main/java/com/qodex/app/runtime/AgentKeepAliveService.kt
Agent engine
- Agent engine
apps/qodex-cli - Tool execution
apps/qodex-cli - Model adapters
apps/qodex-cli/packages/adapters/src/model - Workspace files
apps/qodex-cli/packages/adapters/src/fs
Workflow and trust
- Dynamic workflow
apps/qodex-cli/packages/dynamic-workflow/src/engine/engine.ts - Workflow artifacts
apps/qodex-cli/packages/dynamic-workflow/src/engine/engine-artifacts.ts - Workflow registry
apps/qodex-cli/packages/dynamic-workflow/src/facade/registry.ts - Hook review
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-controller.ts - Hook review types
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-types.ts - Hook telemetry
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-telemetry.ts
Other modules
- Formal proof
packages/formal-proof/src/main.ts - Server runtime paths
packages/qodex-server-cli/src/runtime/paths.ts - Server services
packages/qodex-server-cli/src/platform/serviceManager.ts
Other components
- Android user
- Native utilities
Connections 23
- Android user → Compose interface: submits tasks
README.md - Compose interface → App state: updates state
- App state → RPC client: sends requests
- RPC client → Engine process: stdio RPC
README.md - Engine process → Runtime provisioning: resolves runtime
android/app/src/main/java/com/qodex/app/runtime/EngineProcess.kt - Engine process → Bionic environment: sets environment
android/app/src/main/java/com/qodex/app/runtime/EngineProcess.kt - Engine process → Runtime status: reports phase
android/app/src/main/java/com/qodex/app/runtime/EngineProcess.kt - Engine process → File logging: logs launch
android/app/src/main/java/com/qodex/app/runtime/EngineProcess.kt - Runtime provisioning → Runtime status: reports progress
android/app/src/main/java/com/qodex/app/runtime/Provisioner.kt - Runtime provisioning → File logging: logs setup
android/app/src/main/java/com/qodex/app/runtime/Provisioner.kt - Background service → Engine process: keeps active
- Engine process → Agent engine: starts Node
README.md - Agent engine → Tool execution: dispatches tools
README.md - Agent engine → Model adapters: streams model calls
README.md - Tool execution → Workspace files: reads and edits
README.md - Tool execution → Native utilities: runs utilities
README.md - Agent engine → Dynamic workflow: runs workflows
apps/qodex-cli/packages/dynamic-workflow/src/engine/engine.ts - Dynamic workflow → Workflow artifacts: manages artifacts
apps/qodex-cli/packages/dynamic-workflow/src/engine/engine.ts - Workflow artifacts → Workflow registry: checks presets
apps/qodex-cli/packages/dynamic-workflow/src/engine/engine-artifacts.ts - Agent engine → Hook review: reviews workspace hooks
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-controller.ts - Hook review → Hook review types: uses contracts
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-controller.ts - Hook review → Hook telemetry: supervises review
apps/qodex-cli/packages/bootstrap/src/app/workspace-hook-review-controller.ts - Server services → Server runtime paths: uses runtime paths
packages/qodex-server-cli/src/platform/serviceManager.ts