Run Manifest

Run Manifest creator.

Run

Build Manifest Mode

uvx run-manifest "2026-08-13 09:00:00" "2026-08-13 10:00:01" --used-tokens 13 26 54054 832509 7617 --model opus "test/file1.txt" "test/file2.json" "test/file3.md"

--used-tokens is optional and takes 5 numbers, in order: API requests, fresh input, cache creation (written), cache read (replayed context), output. --model is optional and takes the model name. When omitted, the corresponding field is left out of the manifest.

-o/--output is optional and appends the manifest to a JSON array file, creating it if it doesn't exist:

uvx run-manifest "2026-08-13 09:00:00" "2026-08-13 10:00:01" -o manifest.json "test/file1.txt"

After the first run, manifest.json is created with the manifest as the sole element of the root array (never a bare object):

[
  { ... first run's manifest ... }
]

Running the command again appends a second element to that same array:

[
  { ... first run's manifest ... },
  { ... second run's manifest ... }
]

Expected output manifest (1 record):

{
  "start": "2026-08-13T06:00:00Z",
  "end": "2026-08-13T07:00:01Z",
  "runtime": 3601.0,
  "model": "opus",
  "used-tokens": {
    "api-requests": 13,
    "input": 26,
    "cache-creation": 54054,
    "cache-read": 832509,
    "output": 7617
  },
  "input-files": [
    {
      "name": "test/file1.txt",
      "crc32": "c56b525d"
    },
    {
      "name": "test/file2.json",
      "crc32": "373d4892"
    },
    {
      "name": "test/file3.md",
      "crc32": "98bab5fc"
    }
  ]
}

Check Mode

Verify that a manifest's CRC-32 values still match the files it references:

uvx run-manifest --check manifest.json

manifest.json can be a single manifest object, or a JSON array of manifests such as the one produced by -o/--output above — in that case only the record with the latest end timestamp is checked.

Expected output (one of):

up-to-date

or

outdated: <name of the first file that changed or is missing>

The manifest can also be piped in via stdin instead of a file path:

cat manifest.json | uvx run-manifest --check

Local Run

uvx --from . run-manifest