Getting Started

Quick Start

Build your first world in 5 minutes.

1. Install the CLI

npm install -g @cruxos/cli

2. Create a World

cruxos new my-world

This creates a new directory with a starter world.

3. Edit Your World

Open my-world/world.crux and customize:

world MyWorld {
  seed: 12345

  agent alice: visitor {
    position: { x: 0, y: 0 }
    energy: 100
  }

  rule wander {
    priority: 1
    select: { type: "visitor" }
    when energy > 20
    do wander(speed: 2)
  }
}

4. Run the Simulation

cruxos run my-world/world.json --ticks 100

Next Steps