CLI Overview

Installing opentine creates the tine binary. The CLI works with saved .tine artifacts and can also run native scripts or external harnesses to produce new artifacts.

Installation

Terminal
pip install opentine
Terminal
tine --help

Current Commands

Terminal
tine run <script.py>
tine run --harness codex --prompt "Inspect this repo"
tine show <run.tine>
tine verify <run.tine>
tine ls
tine fork <run.tine> --from-step 3 --save retry.tine
tine replay <run.tine> --inspect
tine replay <run.tine> --mode cache --save replayed.tine
tine diff failed.tine retry.tine
tine resume <run.tine>

Harness Status

Codex CLI and Kimi Code CLI are validated in the current 0.1.x beta environment. Claude Code, Cursor, Hermes, OpenClaw, OpenCode, generic, and Pi profiles are scoped compatibility targets until their local gates pass in your environment.

CommandDescription
tine runExecute a Python script or external harness and save a run graph.
tine showPretty-print a saved run graph.
tine verifyVerify the artifact checksum in metadata.integrity.
tine lsList recent runs in .tine_runs/.
tine forkCreate a new branch from a selected step.
tine replayInspect recorded steps, cache-replay, or rerun through a harness.
tine diffCompare two run graphs by common ancestor and divergence.
tine resumeLoad a resumable artifact only when its manifest declares support.

Run Storage

Commands that accept a run argument take either a direct .tinepath or a run ID prefix resolved from .tine_runs/. When tine run has no explicit save path, it writes to that directory.