Repository navigation
Releases
v1.1.0 — the module framework era
SuperX becomes a platform: everything since v1.0.0 (2026-08-18) arrived as pluggable modules on the epic #141 contract — own database, dir, log, CLI, parameters, UUIDv7 identity, first-class ledger row — while the kernel stayed locked (one author: the operator, now CI-enforced).
Modules
- Entities (epic #166) — the product graph substrate: typed nodes (18 seeded types, runtime-extensible), native SurrealDB edges, identity/state split, text-as-entity, documents as nodes, BFS tree/JSON traversal, full append-only history.
- Runner (epic #189) — schedule any entity, plan dependency waves with cycle refusal, execute task nodes via the configured agent command with parallel dispatch, write results back into the graph, steerable in flight.
- UI, unified (#172–#208) — sessions are the top-level grouping of ALL captured activity; ONE live feed everywhere (history + SSE, chronological, auto-scrolling, every row session-attributed, CVD-validated dark palette); context-window bars, token telemetry, and total-activity counts per session; row-click navigation; whitelisted console.
Framework & operations
- Full module facility contract + live enable/disable + module registration ledger (schema v2.2) +
superx-mod-helloreference + contribution guide (docs/MODULES.md). - Self-upgrading schema path: a new binary on an older substrate never bricks the boot (#158).
- Module contract cemented: KERNEL OFF LIMITS banner + a kernel-immutability CI gate — PRs touching
crates/superx-kernel/fail without an operator-written approval marker (#210). - Capture hardening: sessions attributed from transcript filenames (no more 'unknown'), unparseable lines carry their session (#186),
session_discoveredpayload contract (#209 records the operator ratify/revert decision).
Gates on the release commit: cargo test --workspace · clippy -D warnings · skill_audit — all green in CI.
SuperX v1.0.0 — the Agentic OS
The first release of SuperX: an agentic operating system in Rust, backed by SurrealDB as its filesystem. From the moment it boots, it captures everything every coding agent on the machine does — telemetry AND full conversations — and makes it queryable, historically and live.
One command
superx --initializePrompts you to create the instance password (any password accepted at this phase), starts a local SurrealDB, applies the locked schema, saves credentials (0600), boots the OS in the background, and returns your terminal. Idempotent per instance. superx stop shuts it down gracefully (lands in seconds, even mid-backfill).
Capabilities
- Three agent adapters, built from real machine data — Claude Code (full conversations, history backfill + live), Gemini CLI (conversations with re-emission dedupe and byte-capped backfill), Claude Desktop (honest telemetry-only; it stores no conversations locally). Adding an adapter touches zero engine code.
- Conversations first-class — sessions identified
<agent>/<uuid7>(source id assrc=);superx read <any-unique-fragment> --liverenders history, then follows live. - Everything queryable by agent_id —
agents·sessions·actions [--agent] [--live]·status·logs [--follow]. - Configured, not hardcoded —
params/superx.jsoncontrols all bootstrap config (flag > env > file > fallback) inside the<home>/{params,logs,db}instance layout; runtime tunables live in the substrate as parameters. - The substrate — append-only SCD-2 on SurrealDB, UUIDv7 row ids, typed FK constraints as the debugging surface, minimal-privilege service account (root is used once at initialize, interactively, never stored).
- Engineering — failure-isolated module boot, cursor-checkpointed lossless restarts, tolerant parsing (unknown shapes captured raw, never dropped), kernel self-log, 56 tests, three CI-enforced gates (tests, clippy -D warnings, skill audit).
QA
Operator-verified live: the OS captured and streamed the very Claude Code session in which it was built — superx read <session> --live rendering the conversation as it happened.
Full protocol in the README. Development history: issues #120–#126, PRs #96–#129 across the 2026-08-06 reset (prior system archived at archive/pre-reset-2026-08-06).