Browse documentation
Docs target stable release v0.9.1.Stable vs main checked 2026-10-09

Historical release guide · released 2026-08-16

Upgrade to opentine 0.7

Version 0.7.0 is the Interop & Adoption Release. It adds a completetine export path into OpenTelemetry, a no-code first run through bundled model adapters, one JSON serialization contract across the scriptable CLI, and runnable documentation for the v3 repository workflow.

Upgrade without migrating stored data

Terminal
python -m pip install --upgrade "opentine==0.7.0"
python -c "import opentine; print(opentine.__version__)"

# Confirm the installed release and existing data
tine --help
tine verify representative-v0.6.tine
tine replay representative-v0.6.tine --verify
tine fsck --repo .

Portable artifacts remain .tine v2 and repositories remain v3. Version 0.7.0 continues loading stored data written by releases 0.3.0 through 0.6.0. Upgrading the package does not rewrite existing artifacts or repository objects.

Capture a first run without Python

Terminal
# Use a provider default
tine run --model anthropic --prompt "Explain the current branch"

# Or select provider:model and an explicit destination
tine run --model openai:gpt-5.6 --prompt "Explain the current branch" --save first.tine

--model accepts provider orprovider:model. It is exclusive with a script argument and--harness, and no provider SDK is imported until its adapter is selected. Use the Python API for tools, budgets, or multi-prompt workflows.

Export to OpenTelemetry

Terminal
# Write an OTLP/JSON document
tine export first.tine --output spans.json

# Or send it to an OTLP/HTTP collector
tine export first.tine --endpoint https://collector.example/v1/traces   --service-name research-agent

The default export is an OTLP/JSON GenAI document. --endpoint sends the same serialized document over OTLP/HTTP and fails on connection or non-2xx responses. Cleartext transport is refused unless the target is a literal loopback IP or --allow-insecure is explicit.

Modern telemetry and automation

  • Export includes classic GenAI attributes and semantic-convention 1.36 structured messages, per-event span kinds, a scope schema URL, and cache, reasoning, and total usage dimensions.
  • pricing list, show, check, andupdate all support --json. Export, JSON receipts, and run receipts use the same serializer.
  • Five repository plumbing commands—fsck, object,migrate-v3, fetch, and push—remain bare-JSON interfaces and therefore do not take a redundant --json flag.
  • The signed pricing catalog adds a verified xAI grok-4.6 card, including its long-context tier. GLM 5.3 remains visibly unpriced until a public per-token rate exists.

Release boundary

v0.7.1 subsequently shipped the hardening fixes, and v0.7.2 shipped the catalog and OpenTelemetry billing round-trip patch. Both precede the current v0.9.1 release. Review the release-status guide for the published boundary.

Continue with the current v0.9.1 guide, no-code capture, OpenTelemetry export, or the repository CLI.