Skip to content

v0.1.0 (superseded preview, no downloadable assets)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@RagnarPitla RagnarPitla released this 19 Aug 14:32
· 17 commits to main since this release
v0.1.0
7b41894

Superseded, and there is nothing to download here.

This release has no installable assets. It was tagged before the project
had a native binary or a release pipeline, and before it was renamed from
FridgeBoard to Agent Fridge. It is kept only so the tag and its notes stay
readable.

Install the current release instead:
latest release

# macOS and Linux
curl -fsSL https://github.com/RagnarPitla/agent-fridge/releases/latest/download/install.sh | sh

The notes below are the original v0.1.0 text, left unedited. They describe a
Node-only CLI and an earlier product name, and are historical rather than
current. Agent Fridge is not published to the npm registry.

Multiple AI agents and humans work in one Git checkout without overwriting each other. Local-first, zero runtime dependencies, model-neutral.

The problem this exists for

Two agent terminals coordinated through one shared Markdown file, each doing read-modify-write. One write destroyed about 128 lines of the other agents work. No error. Exit code 0. The losing process had no way to find out.

npm run demo reproduces the class of failure on any machine: 191 lines lost the old way, 0 lost through fridge.

What is in this release

  • The protocol (spec/protocol-v0.1.md): on-disk layout, record schemas, atomic writes, the mkdir registry mutex, claim and scope semantics, leases and staleness, crash recovery, and 12 testable invariants. Enough to reimplement in another language.
  • The exit-code contract (spec/exit-codes.md): 20 codes, generated from source and drift-checked in CI. Exit codes are the public API.
  • Conformance vectors (test/vectors/*.json): language-neutral, so a second implementation can prove conformance without reading any JavaScript.
  • The CLI: 28 commands, zero runtime dependencies, Node >= 20.11.
  • Instruction adapters: one canonical block spliced into AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, Codex, and a generic snippet.
  • Migration: fridge migrate imports To-do.done.md and shared-development-updates.md into immutable notes, with author attribution.
  • 88 tests: unit, integration, and real multi-process concurrency with a start barrier, an unmocked clock, and an unmocked filesystem.

Verified on

Ubuntu, macOS, and Windows, on Node 20 and 22, plus a PowerShell job that asserts the exit-code contract in PowerShell quoting. All 8 CI jobs green.

The design in one line

One writer per record. A claim, a note, and a session are each owned by exactly one actor, so the multi-writer single-file failure mode is structurally absent rather than mitigated. Human-readable views are generated from that state and never edited by hand.

Honest positioning

The shared-board idea is old: blackboard architectures, advisory locking, leases, and tuple spaces all predate this by decades. What is on offer is an open, model-neutral, dependency-free, cross-platform implementation with a written protocol and proof that it holds under real concurrency.

FridgeBoard is cooperative and advisory. It is not a security boundary, and SECURITY.md says so plainly.

Assets 2
Loading