Projects, review and refine, safer batches, and a shared core library.
Projects
codex-img initstarts a project (codex-img.json).--no-eventsturns run logging off for it.- Per-project run history in
.codex-img/runs/, one file per run, with paths relative to the project. Recent projects are listed inprojects.jsonbeside the global log. - An
eventssetting incodex-img.jsonor the globalpresets.jsonturns run logging off persistently.CODEX_IMG_EVENTSstill overrides it. - Event log v2:
generationmarks paid versus free runs,kindsays whether an image is a rerun or an edit, andhistoryPathrecords replaced batch images.
Review and refine
codex-img commentsandcodex-img starslist and change review comments and stars in manifests and batch specs, without reformatting your files.codex-img refine <image> <change>edits only what you ask for, from change text or a saved comment. It warns when a preset changed since the image was made.codex-img rerun <image>generates again from an image's manifest.
Batches
- Re-roll keeps the old image until the new one succeeds, and moves it to
.codex-img/history/. --restorebrings back any earlier version, or any other image.- Per-spec locks: different specs can run at once;
--no-waitfails instead of waiting. --expect-images Nstops before spending quota if the planned count changed.--inspect --jsonreports each asset's state, includingedited.- Conversion is skipped for assets whose generation failed.
Convert and check
codex-img checkvalidates batch specs andcodex-img.jsonagainst new JSON Schemas (schemas/).convert:--nearestfor whole-number pixel-art upscaling,--trim-densityto drop sparse rows under a sprite,--mask-outto see what keying removed, and preview counts in--json.
For developers
crates/codex-img-coreholds the deterministic local processing (codecs, transforms, palettes, sheet, tile, conversion) and the schemas, with no backend or auth code, so other tools can reuse it.convertoutput is pinned byte for byte by golden fixtures.
Full Changelog: v0.7.1...v0.8.0