--evidence also uploads exact retained answer envelopes, which expire from hosted storage after 30 days; screenshot bytes remain local.
Example
--evidence is supplied.
Options
--dirDIR--evidenceopts into retaining local answer envelopes in the hosted project.
Exit status
0 when epoch batches and any requested evidence upload succeed; 1 when an epoch-row batch fails; 2 on configuration or local-file failure, or when--evidence reports skipped or failed evidence uploads.
Behavior and limits
Behavior and limits
Requires an existing cloud connection and project. Uploads epoch summaries in batches of at most 100 rows.Immutable epoch/cell replays deduplicate; conflicts fail. With
--evidence, the command uploads exact local answer envelope bytes with their hashes in bounded batches.Screenshot metadata is included when available, but image bytes remain local. Hosted raw envelopes expire after 30 days; replays do not extend retention.Before sending any raw-evidence batch, the CLI verifies each envelope against its observation identity and retained digest. Changed content, extra fields, duplicate JSON properties and conflicting references stop raw-evidence upload.Historical local digests follow the original writer convention before schema defaults and the screenshot filename; the upload checksum covers the exact stored envelope bytes. The historical digest does not authenticate screenshot pixels.The CLI can hash the current local image for screenshot metadata without uploading that image. Browser egress journals remain local and do not enter this upload.Full command syntax
Full command syntax
Configuration and file contracts
Configuration and file contracts
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.