CLI Overview

Installing opentine creates the tine binary on your PATH. It is the primary interface for running scripts, inspecting run trees, forking from specific steps, replaying executions, and comparing runs side-by-side.

Installation

The CLI is included with the opentine package. No separate install is required.

Terminal

pip install opentine

After installation, verify the binary is available:

Terminal

tine --help

Command Reference

Command	Description
`tine run <script>`	Execute a Python script and save the resulting run tree
`tine show <run_id>`	Display the step hierarchy of a run with costs and durations
`tine ls`	List recent runs (up to 20) in a summary table
`tine fork <run_id>`	Fork a run from a specific step to create a new branch
`tine replay <run_id>`	Replay run steps, printing each step label in order
`tine diff <a> <b>`	Compare two runs side-by-side with match indicators
`tine resume <run_id>`	Resume a paused run by loading it and marking it as running

Run Storage

By default, tine run saves every execution to the .tine_runs/ directory in your current working directory. Each run is stored as a .tine file named by its run ID. All other commands that accept a <run_id> can take either a run ID prefix (which is resolved from .tine_runs/) or a direct path to a .tine file.

Global Options

All commands support --help for usage information. The CLI does not require any configuration files or environment variables beyond what your model adapters need (e.g., ANTHROPIC_API_KEY).