// Use when preparing CPR-vCodex releases, version bumps, GitHub tags, firmware artifacts, release notes, CI checks, GitHub Pages, browser auto-flash, docs/firmware/manifest.json, or docs/flash.html.
Use when modifying CPR-vCodex firmware code, reader behavior, UI activities, rendering, input handling, storage, HAL, EPUB/TXT/XTC parsing, settings, i18n, or ESP32-C3 resource-sensitive C++.
Use when changing CPR-vCodex reading statistics, streaks, achievements, daily goals, manual reading-time corrections, import/export, Reading Stats screens, analytics, or the browser stats editor.
Use when comparing or syncing CPR-vCodex with upstream crosspoint-reader, CrossInk, crosspet, papyrix, or other forks; cherry-picking changes; assessing fork divergence; or deciding whether a third-party feature should be ported.
| name | cpr-release |
| description | Use when preparing CPR-vCodex releases, version bumps, GitHub tags, firmware artifacts, release notes, CI checks, GitHub Pages, browser auto-flash, docs/firmware/manifest.json, or docs/flash.html. |
Read agent-docs/build-and-release.md and agent-docs/autoflash-pages.md
before release work.
git status --short, current branch, and recent tags before editing.python -X utf8 -m platformio run -e gh_release -j 1
python -X utf8 scripts/pre_release_check.py --tag <tag>
python -X utf8 scripts/sync_autoflash_firmware.py --repo franssjz/cpr-vcodex
flash.html/manifest after
publish. If Pages is stale, inspect the workflow rather than editing generated
output by hand.Include the final tag, artifact path, firmware size/budget if measured, checks run, and anything that still depends on GitHub Actions or Pages propagation.