reggie docs

Publishing

From source tree to anchored entry in one command.

The happy path

reggie publish .

This single command:

  1. Packs the directory deterministically into a ZIP archive.
  2. Hashes the ZIP with SHA-256.
  3. Signs the canonicalized entry payload with your active key.
  4. Bonds the entry by posting collateral on Sigil.
  5. Anchors the content hash on Sigil.
  6. Replicates the bytes to the configured Weave DHT shards.
  7. Notifies federated peers via the WebSocket event stream.

Dry-run first

reggie publish . --dry-run

Outputs the entry JSON locally without contacting any registry. Useful for inspecting exactly what will be signed and shipped.

Bond override

reggie publish . --bond 10

Overrides the manifest's publish.bond. Cannot go below the protocol minimum for the given kind/tier.

Federation

reggie publish . --federate

After publishing to your home registry, propagates the entry to every federation peer in your registries.toml. Each peer independently re-anchors on Sigil (idempotent by content hash).