RSOS State Runtime
Shared-state runtime for multi-agent workflows that cuts model calls and heals drift
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- today
About RSOS State Runtime
RSOS State Runtime is an open-source MCP server for agent tooling. It runs locally on your machine and is started by your AI client.
The README describes RSOS as a spatial-symbolic language for communication between humans and AI, and the State Runtime is the part aimed at agent workflows. The model chooses which changes should happen, and the runtime applies them, checks each agent's copy of the shared state, and repairs drift from a stored record without calling a model again.
According to the project's own pre-registered tests on real LLM agents, a 14-step task took 2 model calls instead of 42, and injected drift was healed with zero model calls. The results page also lists failed predictions, which the project reports alongside its passes.
The package installs from PyPI as rsoslang and runs as a local stdio MCP server that Claude Code and other MCP clients can attach to. It is a research and development project and is not described as a medical device.
Install
Run in a terminal
claude mcp add rsos -- uvx rsoslangAdd to claude_desktop_config.json
{
"mcpServers": {
"rsos": {
"command": "uvx",
"args": [
"rsoslang"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rsos": {
"command": "uvx",
"args": [
"rsoslang"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"rsos": {
"type": "stdio",
"command": "uvx",
"args": [
"rsoslang"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rsos": {
"command": "uvx",
"args": [
"rsoslang"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rsos": {
"command": "uvx",
"args": [
"rsoslang"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Hash-checked shared state
- Each agent's copy of the shared state is checked so drift between copies is detected.
- Drift healing without model calls
- Changed parts are restored from a stored record, with no additional model call, according to the project's tests.
- Key-based operations
- The model names the keys to change and the runtime computes the values, so a whole task can fit in one call.
- Local MCP server
- Runs over stdio via the rsoslang package and can be added to Claude Code with a single command.
- Reproducible experiments
- The repository includes a replay script and pre-registered experiments with seeds and result hashes.
Good for
- Coordinating several LLM agents that edit one shared state document
- Reducing model call count and cost in multi-step agent workflows
- Detecting and repairing divergent agent copies of shared data
- Replaying measured agent plans to verify runtime behaviour
- Adding a shared-state layer to an MCP-based coding assistant
Pricing
Open source
Apache 2.0 open-source software installed locally; no paid plan mentioned.
Prices change. Check r-a-elu-architecture.github.io before you buy.
RSOS State Runtime FAQ
How do I install it?
The README gives pip install rsoslang, or pip install -e . from a clone. For MCP, it can be added with claude mcp add rsos -- rsoslang mcp, or with uvx rsoslang mcp without a local install.
What licence is it released under?
The README states the code is licensed under Apache 2.0.
Does it require any API keys or environment variables?
The registry entry lists no environment variables. The README's general MCP configuration example sets RSOS_CUE_FRAMEWORK, which is used for session features.
What were the measured results?
The project reports 2 model calls instead of 42 for a 14-step task, 32/32 correct tasks, and zero model calls for drift healing, with the comparison setup described in its own tests.
Is RSOS State Runtime free?
Yes. RSOS State Runtime is open source, so you can use and self-host it for free.
How do I add RSOS State Runtime to Claude Code?
Run this command in your terminal: claude mcp add rsos -- uvx rsoslang
What are the best alternatives to RSOS State Runtime?
The closest alternatives to RSOS State Runtime are BotShelf Vampire, Agent interoperability design — Atom, Agent context packaging — Atom, Zero trust evaluation verdict — Atom and Zero knowledge claim audit — Atom.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to RSOS State Runtime

BotShelf Vampire
MCP serverRead-only MCP server to search and read free items from the BotShelf Vampire shelf
Not checked yet- 3 tools
- Remote
- Open source
- Agent tooling
Agent interoperability design — Atom
MCP serverDeterministic API/MCP check that grades an agent-interoperability design manifest
Not checked yet- Remote
- Design and media
Agent context packaging — Atom
MCP serverDeterministic verdict on an agent context-pack manifest, per API call
Not checked yet- Remote
- Agent tooling
Zero trust evaluation verdict — Atom
MCP serverPer-call zero trust evaluation verdict for agents and developers, served over MCP and API
Not checked yet- Remote
- AI models and LLM tooling
Zero knowledge claim audit — Atom
MCP serverPay-per-call MCP service that audits zero knowledge claims and returns a deterministic
Not checked yet- Remote
- Security
Network exposure audit — Atom
MCP serverPay-per-call MCP service that audits declared network exposure evidence and returns
Not checked yet- Remote
- Paid
- Security