δ

cruxos.dev

Build Deterministic Worlds

Documentation, tools, and SDK for the cruxOS Foundation

npm install -g @cruxos/cli

Developer Tools

Singularity-level debugging and inspection

⏱️

Time Travel Debugger

Step through any tick

🔍

IR Inspector

Browse world structure

Gas Profiler

Optimize xpt usage

🌱

Seed Explorer

Test determinism

📊

Rule Tracer

Debug rule execution

📋

State Diff

Compare world states

Write Worlds in cruxLang

park.crux
world "cloud-park" {
  size 100x100
  seed 42

  agent visitor {
    state energy: 100
    state mood: "happy"

    behavior wander when energy > 20 {
      move random
      energy -= 1
    }

    behavior rest when energy <= 20 {
      wait
      energy += 5
    }
  }

  spawn visitor count 10
}

The Determinism Contract

same IR + same seed = same world evolution

Every world is reproducible. Every outcome is traceable. Every bug is findable.