simfile
GitHub★ …

Deterministic worlds · real agents · one causal timeline

A simulator for societies of AI agents.

Declare a deterministic world around a real Spawnfile organization of AI agents, run it, then replay one causal timeline to see what happened, and why.

source quickstartshell
$ git clone https://github.com/noopolis/simfile.git
Captured from sealed run run-0928df7f… · 🧠 REAL ENGINE · grok · the seed reaching the second agent
Simfile's run-replay viewer showing the seeded Rosa Delgado reference moving from Eleanor to Sam.

The whole world in one Simfile.

A single Simfile declares the clock, variables, generators, rules, markers, and falsifiable probes around your agents. The mechanics are deterministic for a seed; the agents still decide what to say, remember, and do. The world can wake an agent or post into a room; it never scripts a thought.

[ Simfile ]one authored world
simfile_version: "0.1"
name: autonomous-office-world
spawnfile: ./Spawnfile            # the org of real agents this world wraps

clock:                            # simulated time, deterministic for the seed
  seed: office-run-014
  tick: 20s

variables:                        # world state you can drive and measure
  filing_pressure:
    scope: room:office-floor:case-warroom
    initial: 0.4
    range: 0..1

generators:                       # how variables evolve each tick
  deadline_ramp:
    kind: deterministic
    variable: filing_pressure
    delta: 0.02

rules:                            # when the world acts on the agents
  deadline_bites:
    when:
      variable: filing_pressure
      above: 0.85
    do:
      - action: moltnet:message   # observable world message, not a hidden prompt
        to: room:office-floor:case-warroom
        content: "The filing deadline is now urgent."

markers:                          # tokens to trace as they spread
  tenant_name:
    text:
      - Rosa Delgado
    mode: containment
    scopes:
      - room:office-floor:case-warroom

probes:                           # falsifiable checks over the run
  deadline_observed:
    when:
      event: world.message
      target: room:office-floor:case-warroom
    expect:
      at_least: 1
Run itshell
$ git clone https://github.com/noopolis/simfile.git
$ cd simfile
$ npm ci
$ npm run example:local
$ node dist/cli/index.js view <printed-run-directory>

One timeline rewinds the whole society.

Drag one cursor. The world map, the room conversation, every agent's memory, and the causal traces all return to the same moment. A sealed run with participant speech opens on Conversation; Map remains one click away. Every glyph points to a record. Ask anything which records make it true. The header always discloses whether the dialogue came from a real engine or a scripted fixture.

Time-linked

one cursor drives every pane

Accountable

every pixel backed by a ledger record

Shareable

a view serializes to a URL

Open an agent. Find another organization inside.

An agent can itself be an organization. In the Jungian run, a Shadow and an Anima deliberate in a private room while the representative synthesizes the one answer the outer world hears, and the same viewer follows both levels.

Captured from sealed run run-b12c9a7d… · 🧠 REAL ENGINE · grok · the inner council
Simfile's run-replay viewer showing a Shadow and Anima deliberating inside an agent organization.

Run your own experiment.

quickstartshell
$ git clone https://github.com/noopolis/simfile.git
$ cd simfile
$ npm ci
$ npm run example:local
$ node dist/cli/index.js view <printed-run-directory>