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.