Quickstart
1. Install
Terminal
pip install "opentine[anthropic]==0.7.0"
export ANTHROPIC_API_KEY="..."2. Create a portable artifact
research.py
1from opentine import Agent
2from opentine.models.anthropic import Anthropic
3from opentine.tools.search import search
4from opentine.tools.web import fetch
5
6agent = Agent(
7 model=Anthropic("claude-sonnet-5"),
8 tools=[search, fetch],
9 system="Research the topic and include source URLs.",
10 max_steps=20,
11 autosave_path="research-draft.tine",
12 autosave_every_n_steps=1,
13)
14
15run = agent.run_sync("Explain content-addressed agent artifacts")
16run.save("research.tine")
17print(run.status, len(run.steps), run.total_cost, run.total_duration)
The autosave path receives protected v2 drafts; the final save() writes a clean portable artifact.
3. Verify, inspect, and fork
Terminal
tine verify research.tine
tine show research.tine
tine cost research.tine
tine fork research.tine --from-step 0 --save research-fork-a.tine
tine fork research.tine --from-step 0 --save research-fork-b.tine
tine replay research.tine --mode cache --save research-replay.tine
tine diff research.tine research-fork-a.tine--from-step accepts a zero-based index, full ID, or unique prefix. In v0.4, the two ordinary forks above receive different run IDs even though they retain the same history. Cache replay makes no live calls and deliberately stays deterministic.
4. Continue a native run
continue.py
1continued = agent.resume_sync(
2 run,
3 from_step=run.steps[0].id,
4 prompt="Continue with a concrete operational example.",
5)
6continued.save("research-continued.tine")
5. Import into a v3 repository
Terminal
tine init .
tine migrate-v3 research.tine --repo . --ref heads/research
tine fsck --repo .
tine repo-log heads/research --repo .The migration preserves the exact v2 source bytes as a legacy blob, then creates new redacted and verified v3 objects. See the v0.3 repository guide before synchronizing imported history.
Next
Review the current v0.7 guide, read about v0.4 fork identity, or continue with portable run graphs, repository v3, and live recording.