Weave

Deterministic execution for reproducible debugging—for AI agents and humans.

---

🎯 Overview

Modern software contains non-deterministic bugs that appear randomly and disappear when attempting to reproduce them. Weave eliminates this unpredictability by controlling all sources of randomness, providing a systematic approach to debugging hard-to-reproduce bugs for both AI coding agents and humans with perfect repeatability.

[!NOTE] **Weave is currently in early development and only has [limited support](COMPAT.md) for Darwin/arm64 and Linux/x86.**

Features

• Deterministic time simulation
• Runs on Darwin/arm64 and Linux/x86

🧑‍💻 Getting Started

Install a prebuilt release on supported platforms with:

> curl --proto '=https' --tlsv1.2 -LsSf https://github.com/penberg/weave/releases/latest/download/weave-installer.sh | sh

Prebuilt artifacts are currently published for Darwin/arm64 and Linux/x86_64.

Run your program with `weave` to execute it deterministically:

> weave /bin/date
Sun Mar 10 01:34:50 EET 2041
> weave /bin/date
Sun Mar 10 01:34:50 EET 2041   # Same output, every time!

If you want a different, but reproducible timeline, use the `--seed` flag:

> weave --seed 12345 /bin/date
Fri Jun  2 22:33:25 EEST 2000
> weave --seed 12345 /bin/date
Fri Jun  2 22:33:25 EEST 2000   # Same seed = same result

💡 Motivation

Modern systems intro