How nanocodexyz/nanocode works
Nanocode is a Rust SDK and CLI for embedded frontier-model agents. The main user flow is to submit a prompt through a host or CLI, run it through a Codex or Claude harness, invoke tools (including remote “hands” when needed), and return results while journaling calls for durability. The README also highlights Code Mode, subagents, and multiple payer options. Edges use README-documented capabilities or SOURCE INDEX references; unsampled subsystem internals and wiring are not inferred.
Main entry points: runtime.rs Agent runtime · host.rs Simulated host · app.rs Interactive app · main.rs Nanocode CLI
Components 24
User entrypoints
- Nanocode CLI
bin/nanocode/src/main.rs - Lite CLI
bin/nc-lite/src/main.rs - Front host
bin/nanocode-front/src/main.rs - Interactive app
bin/nanocode/src/app.rs
Agent runtime
- Agent runtime
crates/runtime/agent/src/runtime.rs - Agent router
crates/runtime/agent/src/router.rs - Durable sessions
crates/runtime/durability/src/session.rs - Agent events
bin/nanocode/src/events.rs
Agent capabilities
- Tool execution
crates/backends/codex/src/builtin_tools/standard.rs - Code Mode
crates/runtime/code-mode/src/remote/client.rs - Remote hands
crates/runtime/code-mode/src/remote/hand.rs - Subagents
crates/runtime/subagents/src/routing.rs - Computer integration
crates/integrations/computer/src/engine.rs
Models and payers
- Codex harness
crates/backends/codex/src/agent/driver/mod.rs - Claude harness
crates/backends/claude/src/agent/driver.rs - Model services
- Payer options
crates/backends/codex/client/src/auth/chatgpt.rs
Simulation runtime
- Simulated host
bin/nanocode-sim/src/host.rs - Sim executor
bin/nanocode-sim/src/executor.rs - Sim egress
bin/nanocode-sim/src/egress.rs - Sim random
bin/nanocode-sim/src/rng.rs - Sim streams
bin/nanocode-sim/src/streams.rs - Sim turns
bin/nanocode-sim/src/turns.rs
Other components
- User
Connections 24
- User → Nanocode CLI: submits prompt
- User → Lite CLI: submits prompt
- Nanocode CLI → Agent runtime: runs agent
- Lite CLI → Agent runtime: runs agent
- Front host → Agent runtime: hosts runtime
- Agent runtime → Codex harness: selects harness
- Agent runtime → Claude harness: selects harness
- Codex harness → Model services: calls model
- Claude harness → Model services: calls model
- Agent runtime → Tool execution: invokes tools
- Agent runtime → Durable sessions: journals calls
- Agent runtime → Code Mode: runs program
- Code Mode → Tool execution: calls tools
- Agent runtime → Remote hands: dispatches calls
- Agent runtime → Subagents: spawns sessions
- Agent runtime → Payer options: uses payer
- Payer options → Model services: funds requests
- Interactive app → Agent runtime: submits turns
- Interactive app → Agent events: handles events
bin/nanocode/src/app.rs - Agent runtime → Agent events: emits events
- Remote hands → Computer integration: uses computer
- Simulated host → Sim random: derives randomness
bin/nanocode-sim/src/host.rs - Simulated host → Sim executor: queues futures
bin/nanocode-sim/src/host.rs - Sim egress → Simulated host: uses host
bin/nanocode-sim/src/egress.rs