Quick Start Guide

This step-by-step tutorial takes you from zero to a fully tracked, reproducible development environment in under 2 minutes.

1. Initialize Runmark in Your Project

cd my-project
runmark init

2. Bootstrap an Environment Contract (`runmark.json`)

# Preview discovered evidence without writing files
runmark contract init --dry-run

# Generate the canonical runmark.json contract
runmark contract init --yes

3. Scan Your Environment

runmark scan

4. Check Your Machine Against the Contract

runmark check --explain

5. Capture a Working Baseline Snapshot

runmark snapshot -m "Sprint baseline with Python 3.12 and Postgres 16"

6. Compare State and Spot Drift

runmark diff