Skip to content

SuperX v1.0.0 — the Agentic OS

Choose a tag to compare

View all tags
@k8nstantin k8nstantin released this 18 Aug 15:22
· 204 commits to main since this release
v1.0.0
c5a2d39
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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 --initialize

Prompts 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 as src=); superx read <any-unique-fragment> --live renders history, then follows live.
  • Everything queryable by agent_id — agents · sessions · actions [--agent] [--live] · status · logs [--follow].
  • Configured, not hardcoded — params/superx.json controls 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).

Assets 3
Loading