Skip to main content

Quick Start

Prepare a repo for the Repotoire private beta and inspect the local Machine runtime.

Access

RepoToire is a commercial private beta. Binaries, trusted paths, adapter settings, and team policy are provided during onboarding.

Inspect

cd your-project
repotoire machine report .

That's it. Repotoire will:

  • Read .machine/state.json
  • Report pc, flags, registers, counters, and git fingerprints
  • Show recent events from .machine/events.jsonl
  • Surface traps, hazards, and verification state

Example Output

Repotoire Machine

Repository: ./my-project
pc: 0042
flags.Z: 1
tr: clean
workers: 3
hazards: 0
write_buffer: staged
durable_memory: git HEAD

next gate: VERIFY

Machine Model

ConceptMeaning
Machine ISALOAD, TEST, IMPL, VERIFY, COMMIT, SPAWN, WAIT, JOIN, BNZ, TRAP, HALT
Durable memoryCommitted git history
Write bufferWorking tree changes before explicit COMMIT
EvidenceSource context, worker output, verification verdicts
TrapRecorded stop with a clean restart point

Common Commands

# Inspect state
repotoire machine report .

# Emit a runtime event
repotoire machine emit-event .

# Run the next program transition
repotoire machine evolve .

# Report JSON for policy or CI
repotoire machine report . --format json

Provider Adapters

Provider adapters let Codex, Claude, MCP tools, and local runners execute bounded worker packets without changing Machine semantics.

repotoire machine spawn claude worker.json
repotoire machine join worker-42

Next Steps

Troubleshooting

Machine state is missing

repotoire machine doctor .

A trap blocks progress

repotoire machine report . --format json
tail -n 50 .machine/events.jsonl