Docs target current release v0.5.0.v0.6.0 is in development

Tag and search

Portable v2 tags are mutable metadata outside the artifact digest. The tine tag command re-saves the file, removes any attached signature, and warns; re-sign when the tagged file must remain authenticated.

Terminal
tine tag result.tine --add prod --add regression
tine tag result.tine --remove regression
tine tag result.tine --list

tine search "tag:prod model:claude cost:>0.05"
tine ls --status failed --since 2026-06-01 --cost-min 0.01

# Rebuild .tine_runs/index.json from artifacts
tine reindex

Filters

tine ls and the search DSL support tag, model, exact status, minimum or maximum cost, date bounds, and text matching. tine ls also accepts --limit.

Machine-readable search

Terminal
tine search "tag:prod model:claude" --json

In v0.5, tine search --json emits exactly one object containing command, the joined query, count, and matching runs. A failure that prevents a result remains human-readable and exits nonzero. The mutating tag and reindex commands do not accept this JSON mode.

Rebuildable index

.tine_runs/index.json is a sidecar for fast lookup, not the source of truth. tine reindex reconstructs it from .tine artifacts in that directory.

These commands target the legacy file index, not the v3 repository. Use repository search APIs and refs for .tine/ history.