Current 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

The open v0.7.1 hardening work is not part of the 0.7.0 wheel. Review the release-status guide for its credential, attestation, export, and round-trip fixes without treating them as shipped behavior.

Continue with no-code capture, OpenTelemetry export, or the repository CLI.