Repository navigation
RSO Context Alpha 0.9.4
Pre-releaseAny agent host can now use RSO on any bounded project folder through MCP. Host entries used to pin the folders named at setup time, so an agent working anywhere else was refused; that was the usual reason agents reported they could not run RSO.
Install
Download RSOContextAlpha-0.9.4.zip, extract it, and run python -B install.py from the extracted folder. rso-context --version should report 0.9.4 and doctor should report ready: true. Then run rso-context mcp --setup --client all and restart your agent apps. INSTALL.md covers Windows, Linux and macOS paths; QUICKSTART.md is the beginner walkthrough.
Requires Python 3.11 or newer, Git, and Python's standard-library SQLite with FTS5. The core CLI needs no pip packages, API key or network service.
sha256 of the attached ZIP: 2ce25c2e72a42358f4a74f416f4a65b16a524391eb5e32a9beec4f02ec9826a3 (62 files, 209,170 bytes). The same value is in the attached .sha256 file.
Changed
- MCP access is open by default. A tool call may name any bounded project folder, whether or not it sits under a launch
--root.--strict-rootsrestores launch-only access. - One bounded-folder rule covers every MCP path, launch roots included. It refuses filesystem roots, user profiles and folders that contain one, other accounts' profiles, Desktop, Documents, Downloads, OneDrive roots, hidden profile folders such as
.ssh, operating-system folders, and the ledger home. - The server starts however a host launches it. A desktop app that starts servers from its install folder or the user profile used to get a startup error; that directory is now simply not used as a root.
mcp --setuppins no--rootunless one is given. A rewrite keeps keys you added to a JSON entry and Codex tool-approval tables.
Added
mcp --setup --client allconfigures every installed host and lists the ones it skipped. New hosts:claude-desktop,cursor,windsurf.- The CLI accepts
--client opencode; the parser used to reject it even though setup supported it.doctorreports every supported host.
Fixed
rso_query,rso_checkandrso_expandcould return an emptyinsufficient_budgetpacket at the default byte budget. JSON escaping made the wire result a few bytes larger than the packet, and the shrink loop fell back to 256 bytes before getting under. The budget is now found by binary search.- A host that replaces the child environment left Git off
PATH. Ingest stopped with a generic error, and project identity fell back to a non-Git key, so one checkout could register as two projects. RSO now finds Git throughRSO_GIT,PATH, or the standard Windows install folders, and setup writesRSO_GITinto the entry. - The user-profile refusal no longer depends on
USERPROFILEorHOME; it asks the operating system for the profile folder. - Every tool failure now reports its reason instead of "Error executing tool".
Verified, and what is not
176 regression tests pass with one POSIX-only skip. GitHub Actions passed on Windows, Ubuntu and macOS with Python 3.11 and 3.12 for both merges in this release. The attached ZIP was rebuilt from the tagged commit and matches, byte for byte, the archive that was installed into a temporary prefix and checked with a scratch ledger (--version 0.9.4, doctor ready).
Open access was checked live over stdio the way a desktop app launches servers: working directory set to the user profile, no --root, environment reduced to SystemRoot and a System32 PATH. On a folder outside every previously configured root, rso_use ingested 35 files, rso_query returned six evidence spans at the default budget, and rso_use on the profile was refused. The entries written by --setup --client all for Codex, Claude Code, Claude Desktop, Cursor, Gemini CLI, Antigravity and OpenCode were each started with their own command and environment and gave the same results.
That checks the entries, not the host applications. Acceptance inside each app after a restart is unverified, as are Windsurf and native macOS live-agent use. See VERIFICATION.md for the recorded scope.
This is an alpha pre-release.