Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@ differ after documented presentation-only cleanup.
- Look directions preserve identity and pass the four cardinal gates: up, screen-right, down, and screen-left.
- Deterministic validation reports no errors.
- The preview and QA images were produced from the exact submitted atlas.
- `catalog.json`, every affected root README block, and the one-click install link are updated in the same pull request.
- `catalog.json`, every affected root README block, and the installer deep link are updated in the same pull request.
- Maintainer-initiated site content, installer copy, previews, alt text, and cache tokens agree before merge.

Do not submit an unreviewed generated atlas, a flattened image without transparency, or a package whose metadata and spritesheet disagree.
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

**Small companions. Serious sprites.**

An independent community catalogue of custom animated pets for the Codex desktop app, packaged with one-click install links and reviewable validation evidence.
An independent community catalogue of custom animated pets for the Codex desktop app, with guided installer pages and validation evidence you can review.

![Pets](https://img.shields.io/badge/pets-7-67e8f9?style=flat-square)
![Sprite format](https://img.shields.io/badge/sprite%20format-v2-a78bfa?style=flat-square)
Expand Down Expand Up @@ -52,7 +52,7 @@ Calian and Scarlet form a sister act of unmatched diligence: Calian isolates dec

## Install a pet

Each HTTPS install page opens the pet installation flow when Pets are enabled for your account. It also provides direct package downloads as a fallback because GitHub removes custom `codex://` links from rendered README files.
Each HTTPS installer page offers an **Open in Codex** handoff and direct package downloads. Your browser may ask for permission to open the desktop app; if the handoff is unavailable, the package links remain available. GitHub removes custom `codex://` links from rendered README files.

| Pet | ID | Installer | README |
| --- | --- | --- | --- |
Expand Down Expand Up @@ -93,7 +93,7 @@ Every published pet includes:
- direction and continuity review;
- public QA sheets and a sanitized validation summary.

All 7 published pets ship as exact `1536 × 2288` RGBA WebP atlases. Their published spritesheets match their fully reviewed local packages byte-for-byte.
All 7 published pets ship as exact `1536 × 2288` RGBA WebP atlases. Each published spritesheet's SHA-256 matches `catalog.json` and its linked validation summary.

| Pet | SHA-256 | Validation |
| --- | --- | --- |
Expand Down
4 changes: 2 additions & 2 deletions docs/releases/v1.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,15 @@ The benches are lit, the reactor is humming, and seven very different companions

- Seven validated v2 pet packages, each with an exact `1536 × 2288` RGBA WebP atlas, nine standard animation rows, two look-direction rows, and 16 directional poses.
- Animated previews rendered from the current validated atlases—not stand-ins or redrawn approximations.
- One-click HTTPS installer pages for every pet, with direct `pet.json` and `spritesheet.webp` package links as a practical fallback.
- HTTPS installer pages for every pet, with a browser-to-app handoff and direct `pet.json` and `spritesheet.webp` package links as a practical fallback.
- Inspectable QA evidence: contact sheets, look-direction sheets, sanitized validation summaries, and recorded SHA-256 checksums.
- A responsive public catalogue with equal treatment for every companion, clear package links, and contribution routes for the next one.
- An independent community project with no vendor branding or implied official affiliation.

## Install a companion

1. Open the **[Codex Pets catalogue](https://senyo888.github.io/codex-pets/)**.
2. Choose a companion and select **Install**. The HTTPS installer hands off to the desktop app and keeps direct package links available if the handoff is unavailable.
2. Choose a companion and select **Install**. Your browser may ask for permission to open the desktop app; direct package links remain available if the handoff is unavailable.
3. In the app, open **Settings → Pets**, select the pet, then enter `/pet` or choose **Wake Pet** from the command menu.

If you use the manual package fallback, keep `pet.json` and `spritesheet.webp` together in the same local pet directory, then refresh **Settings → Pets** before selecting the pet.
Expand Down
2 changes: 1 addition & 1 deletion pets/aethercore/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Its evolved ivory-and-champagne shell now carries a richer brushed-metal finish,
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `5ad38c56af287375f32e3706f119720a6c9122e8b5490a7fd7d6e07b05fc44dd` |

The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
2 changes: 1 addition & 1 deletion pets/aethermite/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ The animation set uses deliberate perspective shifts, grounded contact shadows,
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `13869434db6f58f07c0d2571def9d8da624bc77416adc4964727084d23840384` |

The package contains the exact validated spritesheet and matching sanitized metadata. No rescaling, recompression, or post-validation sprite editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
2 changes: 1 addition & 1 deletion pets/aetherwing/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Four modern articulated wings make flight her chosen form of movement. Direction
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `c5b03756e270516b8200b75cef811e094f768638633273eadc3ce0c6fa5002fa` |

The package contains the exact validated spritesheet and matching sanitized metadata. No rescaling, recompression, or post-validation sprite editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
2 changes: 1 addition & 1 deletion pets/bella/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ The remaining standard states retain Bella's established movement language, and
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `548cb72d381fcc861f5017f0213c3d794ce2210d4b9781a58ee53331aa43344d` |

The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
2 changes: 1 addition & 1 deletion pets/calian/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Calian and [Scarlet](../scarlet/README.md) work as a coordinated pair. Calian is
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `4b9ac6125a4222a5e2391ba04ee3bf0a0b6c2fcd98aa07c8f2b2322dd614933b` |

The package contains the exact validated spritesheet and matching sanitized metadata. No rescaling, recompression, or post-validation sprite editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
2 changes: 1 addition & 1 deletion pets/scarlet/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Her premium CGI identity combines a readable sculpted face, short flame-crown ha
| Animation rows | 9 standard + 2 look-direction rows |
| SHA-256 | `f94405dc13396f703b600f4462342d5928ec7716461c86ad96551fec63b54840` |

The package contains the exact validated spritesheet and matching sanitized metadata. No rescaling, recompression, or post-validation sprite editing was applied before publication.
The package contains the exact validated spritesheet and its matching `pet.json`. No rescaling, recompression, or post-validation sprite editing was applied before publication.

## Install

Expand Down
6 changes: 3 additions & 3 deletions site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@
<p class="eyebrow">Community pet catalogue</p>
<h1 id="page-title"><span class="title-main">Codex</span><span class="title-accent">Pets</span></h1>
<p class="hero-kicker">Small companions. Serious sprites.</p>
<p class="lede">Animated desktop pets with transparent packages, one-click installers, and validation evidence you can inspect.</p>
<p class="lede">Animated desktop pets with inspectable packages, guided installers, and validation evidence you can review.</p>
</div>
<dl class="hero-stats" aria-label="Collection status">
<div><dt>Published pets</dt><dd>7</dd></div>
Expand Down Expand Up @@ -268,8 +268,8 @@ <h2 id="standards-title">Delightful in motion. Boringly reliable as a package.</
</div>
<div class="standards-grid">
<article>
<h3>Transparent packages</h3>
<p>Every pet ships with clean source files, a preview, metadata, and a recorded checksum.</p>
<h3>Inspectable packages</h3>
<p>Every pet ships with its spritesheet, metadata, preview, and recorded checksum.</p>
</article>
<article>
<h3>Deterministic validation</h3>
Expand Down
2 changes: 1 addition & 1 deletion site/install/aetherbite/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake Aetherbite?</h1>
<p>Aetherbite is Humidity Intelligence's bio-digital systems tinkerer, shaped through cinematic dimensional spritework with crystalline wings, layered articulated armour, and expressive motion.</p>
<a class="button button-wide" id="install-aetherbite" href="codex://pets/install?name=Aetherbite&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Faetherbite%2Fspritesheet.webp&amp;description=Aetherbite%20is%20Humidity%20Intelligence%27s%20bio-digital%20systems%20tinkerer%2C%20shaped%20through%20cinematic%20dimensional%20spritework%20with%20crystalline%20wings%2C%20layered%20articulated%20armour%2C%20and%20expressive%20motion.&amp;spriteVersionNumber=2">Open Aetherbite in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/aethercore/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake AetherCore?</h1>
<p>A calm governance-engine pet for Humidity Intelligence continuity and coherence.</p>
<a class="button button-wide" id="install-aethercore" href="codex://pets/install?name=AetherCore&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Faethercore%2Fspritesheet.webp&amp;description=A%20calm%20governance-engine%20pet%20for%20Humidity%20Intelligence%20continuity%20and%20coherence.&amp;spriteVersionNumber=2">Open AetherCore in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/aethermite/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake AetherMite?</h1>
<p>A premium dimensional bio-digital systems champion for Humidity Intelligence, with a layered bronze-and-silver shell and luminous environmental core.</p>
<a class="button button-wide" id="install-aethermite" href="codex://pets/install?name=AetherMite&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Faethermite%2Fspritesheet.webp&amp;description=A%20premium%20dimensional%20bio-digital%20systems%20champion%20for%20Humidity%20Intelligence%2C%20with%20a%20layered%20bronze-and-silver%20shell%20and%20luminous%20environmental%20core.&amp;spriteVersionNumber=2">Open AetherMite in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/aetherwing/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake AetherWing?</h1>
<p>A calm guardian companion for Humidity Intelligence, protecting deterministic runtime control, architectural discipline, and truth-backed dashboard behaviour.</p>
<a class="button button-wide" id="install-aetherwing" href="codex://pets/install?name=AetherWing&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Faetherwing%2Fspritesheet.webp&amp;description=A%20calm%20guardian%20companion%20for%20Humidity%20Intelligence%2C%20protecting%20deterministic%20runtime%20control%2C%20architectural%20discipline%2C%20and%20truth-backed%20dashboard%20behaviour.&amp;spriteVersionNumber=2">Open AetherWing in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/bella/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake Bella?</h1>
<p>The 1 True Source, a luminous crystalline coherence guardian with layered dimensional detail and deterministic grace.</p>
<a class="button button-wide" id="install-bella" href="codex://pets/install?name=Bella&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Fbella%2Fspritesheet.webp&amp;description=The%201%20True%20Source%2C%20a%20luminous%20crystalline%20coherence%20guardian%20with%20layered%20dimensional%20detail%20and%20deterministic%20grace.&amp;spriteVersionNumber=2">Open Bella in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/calian/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake Calian?</h1>
<p>One half of a sister act of unmatched diligence, Calian is a calm tactical guardian who isolates decisive faults and restores deliberate control.</p>
<a class="button button-wide" id="install-calian" href="codex://pets/install?name=Calian&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Fcalian%2Fspritesheet.webp&amp;description=One%20half%20of%20a%20sister%20act%20of%20unmatched%20diligence%2C%20Calian%20is%20a%20calm%20tactical%20guardian%20who%20isolates%20decisive%20faults%20and%20restores%20deliberate%20control.&amp;spriteVersionNumber=2">Open Calian in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down
2 changes: 1 addition & 1 deletion site/install/scarlet/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<h1>Wake Scarlet?</h1>
<p>One half of a sister act of unmatched diligence, Scarlet is a poised CGI guardian who traces drift, protects execution integrity, and drives every correction to verified closure.</p>
<a class="button button-wide" id="install-scarlet" href="codex://pets/install?name=Scarlet&amp;imageUrl=https%3A%2F%2Fraw.githubusercontent.com%2Fsenyo888%2Fcodex-pets%2Fmain%2Fpets%2Fscarlet%2Fspritesheet.webp&amp;description=One%20half%20of%20a%20sister%20act%20of%20unmatched%20diligence%2C%20Scarlet%20is%20a%20poised%20CGI%20guardian%20who%20traces%20drift%2C%20protects%20execution%20integrity%2C%20and%20drives%20every%20correction%20to%20verified%20closure.&amp;spriteVersionNumber=2">Open Scarlet in Codex</a>
<p class="install-note">Your browser may ask for permission to open the desktop app. Pets must be enabled for your account.</p>
<p class="install-note">Your browser may ask for permission to open the desktop app. If the handoff is unavailable, use the package links below.</p>
<details class="fallback">
<summary>Installer did not open?</summary>
<ol>
Expand Down