Getting started
Install & run
From source
Build from the Rust workspace in ~/w/gode. The primary binary is
roder, provided by crates/roder-cli.
cd ~/w/gode
cargo build --workspace
cargo test -p roder-cli
cargo run -p roder-cli Configuration
Roder reads ~/.roder/config.toml and supports environment overrides for
common defaults.
RODER_PROVIDER=openai RODER_MODEL=gpt-5.5 cargo run -p roder-cli
RODER_PROVIDER=openrouter RODER_MODEL=x-ai/grok-build-0.1 cargo run -p roder-cli
RODER_PROVIDER=mock cargo run -p roder-cli Provider API keys can be set through config or the provider-specific environment keys. The default distribution resolves OpenAI, Anthropic, Gemini, OpenRouter, Codex OAuth, web search, subagent, JSONL session, memory, and built-in tool extensions from that configuration.
Policy modes
The CLI accepts policy controls that flow into the runtime policy gate.
cargo run -p roder-cli -- --mode plan
cargo run -p roder-cli -- --mode accept-edits
cargo run -p roder-cli -- --yolo App server
Start the local JSON-RPC control plane over stdio when building a desktop client, integration test, or automation wrapper.
cargo run -p roder-cli -- app-server
cargo run -p roder-cli -- app-server --mode plan Remote mode. Use
roder app-server --remote for the
authenticated WebSocket transport when pairing trusted local-network clients. The
agent-node roadmap adds a stricter Roder-to-Roder mode with mandatory encrypted
transport for non-loopback control.