Skip to content
Sigil-Forge
Pipeline Proof Install GitHub
Bronze monogram sigil on a dark geometric plate field

v0.13.0 · Hermes skill · MIT

Intent, layered into the image.

Corpus methods forge the glyph. The end product is the wallpaper — atmosphere, geometry, and an encrypted vault of intent and method provenance sealed into the PNG.

00 · Craft

A skill, not a plugin.

Sigil-Forge installs as a standalone Hermes skill (~/.hermes/skills/sigil-forge). The agent owns intake and framing; the engine owns geometry, digests, and carriers. No image API required.

Wizard

Step runner

One question per turn via wizard --next. Quick path for most users; full path for craft options and Proof of Intent.

Geometry

Spare + kamea fuse

Monogram reduction, magic-square paths, Rose Cross, bind-runes, optional planetary plate strokes — never hand-invented by the agent.

Product

Wallpaper vault

Composite + SF12 LSB vault: intent and methods encrypted in the image. Public digests for verify; passphrase opens the vault.

Provenance

Layered encoding

Geometry respects Spare/kamea/Rose/bind/planetary corpus. Packet files are workspace — the handoff is the wallpaper PNG.

01 · Pipeline

From intent to verify.

Safety and authority-seal gates first. Then normalize, digest, fuse layout, stego, packet, optional capsule — and recover the digest with verify.

  1. 01

    Guide or construct

    Hermes loops the wizard step runner, or experts call construct --intent "…" directly.

  2. 02

    Emit the run

    glyph.svg / glyph.png, forge-packet.json, forge-manifest.json, sigil_root — under out/sigil-forge/<run-id>/.

  3. 03

    Verify & inspect

    Recover digest (and root when SF11). Optional open --capsule and verify-proof for sealed witnesses.

02 · Surfaces

What a run leaves behind.

intent_digest SHA-256 of normalized intent — geometry + legacy stego
intent_commitment Salted per-run commitment (value public; nonce private)
sigil_root Merkle root over public leaves — no self-reference
intent-capsule.json Sealed witness when passphrase + --proof commitment
proof modes none · commitment · zk-knowledge · zk-forge (Noir/risc0 skip if unavailable)
policy No default efficacy claims; authority-seal requests excluded from the default forge; learning ledger stays PROPOSED

03 · Install

Clone, install, forge.

Python 3.10+ stdlib for the core path. Optional argon2-cffi and jsonschema. Lean install excludes implementation plans under docs/superpowers. 

# install as Hermes skill
bash install.sh

# product path — wallpaper with sealed vault
export SIGIL_FORGE_PASSPHRASE='…'
python3 scripts/sigil_forge.py construct \
  --intent "I maintain calm focus" \
  --wallpaper --surface phone_lock --embed vault

# open the deliverable
python3 scripts/sigil_forge.py open --wallpaper \
  out/sigil-forge/*/wallpaper/phone-lock.png --json
Open repository Quickstart SKILL.md