opencodeR

Rust port of the OpenCode AI coding agent.

opencodeR is a full-featured HTTP API server and CLI client for AI-assisted coding, rewritten from the original opencode TypeScript codebase into Rust. It provides the same API surface with better performance, lower memory usage, and cross-platform binaries.

Quick Start

# Download the latest release for your platform
curl -fsSL https://github.com/grave0x/opencodeR/releases/latest/download/opencodeR-x86_64-unknown-linux-gnu.tar.gz | tar xz
# Start the server
./opencodeR-server --headless --port 8081
# In another terminal, run a prompt
./opencodeR run "Explain this codebase" --port 8081

Binaries

Binary	Description	Default mode
opencodeR	Combined binary — server + client + TUI	opencode-style agent chat TUI (home screen → sessions)
opencodeR-server	HTTP API server	Server dashboard TUI (--headless for headless)
opencodeR-client	Remote CLI client	Connects to running server (--base-url)

opencodeR (combined)

USAGE:
opencodeR [COMMAND]
COMMANDS:
server Start the headless HTTP server
client Connect to a remote server interactively
run Run a one-shot prompt and exit
tui Launch the server dashboard TUI
sessions List sessions from a running server
models List available AI models
providers List configured providers
agents List available agents
export Export a session as JSON
import Import session data from JSON file
completion Generate shell completion script

opencodeR-server

# Server dashboard TUI (default)
opencodeR-server
# Headless mode
opencodeR-server --headless --port 8081 --password mysecret

opencodeR-client

# Interactive REPL
opencodeR-client --base-url http://127.0.0.1:8081
# One-shot prompt
opencodeR-client --base-url http://127.0.0.1:8081 --one-shot "Refactor this"

API Endpoints

The server implements the full opencode HTTP API:

Group	Endpoints	Status
Health	GET /api/health	✅
Sessions	CRUD + prompt, events, history, messages, revert, interrupt, context, wait	✅
Agents	GET /api/agent	✅
Models	GET /api/model	✅
Providers	GET /api/provider/:id	✅
Filesystem	GET /api/fs/read/*path, list, find	✅
PTY	CRUD + connect token, WebSocket connect	✅ (real processes)
Events	GET /api/event (SSE)	✅
Integrations	List, connect key/OAuth, attempt flow	✅
Permissions	Request/reply flow, saved rules	✅
Questions	Ask/reply/reject	✅
Commands	GET /api/command	✅
Skills	GET /api/skill	✅
Auth	Password-based Basic auth middleware	✅

Architecture

 ┌─────────────────────────┐
│ opencodeR binary │
│ (CLI / TUI / Server) │
└─────────┬───────────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Server │ │ Client │ │ TUI │
│ Crate │ │ Crate │ │ (ratatui)│
└────┬─────┘ └────┬─────┘ └──────────┘
│ │
└──────┬───────┘
▼
┌──────────────┐
│ Core Crate │
│ (traits + │
│ in-memory) │
└──────┬───────┘
│
┌──────┴───────┐
│ Schema + │
│ Protocol │
│ Crates │
└──────────────┘

Crate structure

Crate	Purpose
opencode-r-schema	Data types (session, agent, model, provider, PTY, etc.)
opencode-r-protocol	HTTP routes, error types, request/response payloads
opencode-r-core	Service traits + in-memory implementations
opencode-r-server	Axum router, handlers, middleware (auth, access log)
opencode-r-client	HTTP client library for the API
opencode-r-cli	Binary entry points + TUI
opencode-r-llm	LLM provider abstraction (in progress)
opencode-r-plugin	Plugin system (in progress)

Building from source

git clone https://github.com/grave0x/opencodeR.git
cd opencodeR
cargo build --release --bin opencodeR --bin opencodeR-server --bin opencodeR-client

The release binaries will be in target/release/.

Cross-compilation

# Linux ARM64
cargo build --release --target aarch64-unknown-linux-gnu --bin opencodeR
# Windows
cargo build --release --target x86_64-pc-windows-msvc --bin opencodeR

Packaging

Format	Location
Arch Linux	packaging/arch/PKGBUILD
Debian/Ubuntu	packaging/debian/
RPM (Fedora/RHEL)	packaging/rpm/opencodeR.spec
Cargo	cargo install opencode-r-cli

Configuration

Environment variable	Default	Description
OPENCODE_PORT	8081	Server port
OPENCODE_PASSWORD	(none)	Enable Basic auth
OPENCODE_BASE_URL	http://127.0.0.1:8081	Server URL for client
RUST_LOG	info	Log level (e.g. debug, opencode_r_server=info)

Feature comparison

See features/feature-comparison.json for a detailed comparison between opencodeR and the original opencode.

See features/ROADMAP.md for the planned feature roadmap.

License

MIT — see LICENSE.