PixLog v0.1.1

PixLog v0.1.1

This release makes PixLog straightforward to discover, install, and try while
keeping its Git-native architecture unchanged.

What's New

• A runnable five-commit demo inside demo/workspace, built from licensed source
  images with real pixlog run -- magick ... commands.
• Chafa-powered inline before/after/heatmap previews for interactive terminals,
  with JSON and NDJSON output kept control-sequence free.
• The versioned PixLog Visual Policy composite Action for pull requests.
• Canonical Go module path github.com/zhao-xuan/PixLog, enabling standard remote
  go install commands.
• Reproducible README stills, demo recordings, and a 1280x640 social preview.

Install

brew install zhao-xuan/tap/pixlog chafa

Or install the two command entry points with Go:

go install github.com/zhao-xuan/PixLog/cmd/pixlog@v0.1.1
go install github.com/zhao-xuan/PixLog/cmd/git-pixlog@v0.1.1

Try the Demo

git clone https://github.com/zhao-xuan/PixLog.git
cd PixLog
brew install zhao-xuan/tap/pixlog chafa imagemagick
bash demo/setup.sh
cd demo/workspace
pixlog diff HEAD~1 HEAD -- assets/hero.png

GitHub Action

- uses: actions/checkout@v4
  with:
    fetch-depth: 0
- uses: zhao-xuan/PixLog@v0.1.1
  with:
    policy: .pixlog-policy.json

Known Limitations

• Built-in pixel decoding currently covers PNG, JPEG, and GIF. Other recognized
  formats retain exact-byte history and provenance but may not have visual diff.
• Photoshop and browser adapters still require host packaging and validation.
• There is no hosted collaboration service, HTTP lock service, or Web review UI.
• Hosted-model recipes may be provenance-only and are not claimed to reproduce
  deterministically when parameters are unavailable.

Full changelog: v0.1.0...v0.1.1

PixLog v0.1.0

PixLog v0.1.0

Git tells you an image blob changed. PixLog shows which pixels changed, which
commit introduced them, and how the asset was produced, while Git remains the
only commit graph.

Highlights

• Pixel-aware diffs with visual-change ratio, RMSE, SSIM, changed regions, and
  heatmap export.
• Visual blame that traces a coordinate through Git history and renames.
• Exact-byte media objects, Git pointer filters, file/HTTP Batch transfer, and
  hydration.
• Generation recipes, local capture journal, metadata inspection, and guarded
  reproduction.
• Visual policies for formats, sizes, recipes, SSIM, masks, and protected regions.

Install

brew install zhao-xuan/tap/pixlog chafa
pixlog init

Prebuilt archives for Linux, macOS, and Windows are attached below with SHA-256
checksums. The current runnable demo
is maintained in the main repository.

Known Limitations

• Built-in pixel decoding currently covers PNG, JPEG, and GIF. Other recognized
  formats retain exact-byte history and provenance but may not have visual diff.
• Photoshop and browser adapters still require host packaging and validation.
• There is no hosted collaboration service or Web review UI.
• Hosted-model recipes may be provenance-only; PixLog does not invent unknown
  seeds, steps, or deterministic-reproduction claims.

Full changelog: https://github.com/zhao-xuan/PixLog/commits/v0.1.0