Persisting

Persistent infrastructure for the Agent era.

Persisting connects durable model state—parameters and KV caches—with durable Agent history—trajectories and execution records. The current product is the path from execution to queryable history:

Governed execution	Durable history

• pvisor is an executor that produces persistable, reviewable facts: staged Effects and execution records from one Agent Run;
• pchronicle browses, queries, exchanges, and serves trajectory Datasets.

Each command works on its own. Connected, they cover pvisor run --stage … → review/apply → configured capture → a queryable Dataset.

Install

pip install persisting[lance]
pvisor --version
pchronicle --version

The rolling nightly build installs the same commands without a Rust toolchain:

curl -fsSL https://raw.githubusercontent.com/DeepLink-org/Persisting/main/scripts/install-nightly.sh | bash

See the installation guide for platform requirements and executor setup.

Run one Agent and review its changes

pvisor run --stage ./runs/task-001 -- codex
pvisor review last
pvisor apply last --all   # or: pvisor drop last

--stage creates a copy-on-write workspace view for review; without it the Agent may write the real project tree. The exact boundary is platform-dependent and recorded with the Run—consult the execution guide before treating it as a security boundary.

Query Agent trajectory history

pchronicle onboard
pchronicle onboard query
pchronicle agent codex ./trajectory-data --ask "Which tools fail most often?"

The onboarding flow creates a temporary example Dataset—no source checkout required. pchronicle import accepts ATIF, ACTF, and OpenAI Messages; pchronicle serve starts a loopback-only, read-only Dataset UI and API.

After capture is configured, selected pVisor Run events can enter a pChronicle Dataset. See the capture guide.

Current maturity

Documentation

• Choose a workflow — pick the entry point that matches your task
• Run your first Agent — the run-review-apply loop
• Explore durable history — browse and query a trajectory Dataset
• Project architecture — ownership and delivery boundaries

Criterion.rs microbenchmarks and hyperfine lifecycle scenarios are compared against main in CI; see the benchmark contract.

Latest nightly pChronicle benchmark: d628946b6ac4 on linux/x86_64 (2026-09-11T11:26:09.379341+00:00).

Open the complete benchmark run.

License

Apache License 2.0. See NOTICE for third-party attributions and separately licensed bundled components.