Skip to content

RexOS

Long-running Agent OS: durable harness + SQLite memory + sandboxed tools + multi-provider routing.

Get started (Ollama) Harness tutorial Providers & routing Use cases

Develop locally with small models on Ollama, then switch routing to GLM / MiniMax / DeepSeek / Kimi / Qwen / NVIDIA NIM when you need more capability.

  • :material-checklist: Harness-first long tasks
    Work like “change → verify → checkpoint”, across many runs.
    Learn harness

  • SQLite-backed memory
    Sessions, messages, and small KV state live in ~/.rexos/rexos.db.
    Concepts

  • Sandboxed tools
    Workspace-scoped file IO + shell + SSRF-protected web_fetch.
    Security model

  • Multi-provider routing
    Route planning/coding/summary to different providers/models.
    Configure providers

Quickstart (local, with Ollama)

1
2
3
4
5
6
7
8
9
# 1) Start Ollama
ollama serve

# 2) Init RexOS (~/.rexos/config.toml + ~/.rexos/rexos.db)
rexos init

# 3) Run a workspace session
mkdir -p /tmp/rexos-work
rexos agent run --workspace /tmp/rexos-work --prompt "Create hello.txt with the word hi"

How it works

flowchart LR
  U[You] -->|prompt| R[RexOS CLI]
  R --> M[(SQLite memory)]
  R --> W[(Workspace sandbox)]
  R --> G[(Git checkpoints)]
  R --> T[Tools: fs_read/fs_write/shell/web_fetch]
  R --> X{Router}
  X -->|planning| P[Small/local model]
  X -->|coding| C[Stronger model]
  X -->|summary| S[Cheap summarizer]

Next steps

  • Learn the harness loop: tutorials/harness-long-task.md
  • Explore common recipes: how-to/use-cases.md
  • Switch providers (GLM/MiniMax native + NVIDIA NIM included): how-to/providers.md