trajectoriz
Library to work with agent trajectory files. Support Claude, Codex, OpenCode and others
Installation
pip install trajectoriz
Features
- Unified record API — iterate and parse sessions from Claude Code, Codex, Copilot, OpenCode, Hermes and more through a single
iter_records()/parse_record()interface - Full-content search — three backends: in-process
grep(default, no setup),recoll(Xapian index),sqlite(FTS5 index) - Blame — trace every agent edit to a file across all trajectory sources, with line/char deltas
- HTML export —
trajectoriz-cli show <id> --htmlrenders a trajectory as a self-contained HTML page
CLI
# List trajectories in the current directory
trajectoriz-cli list
# Search all trajectories for a keyword (in-process grep, default)
# Show a trajectory (markdown, paginated)
trajectoriz-cli show cl-1234abcd
trajectoriz-cli show cl-1234abcd --last
trajectoriz-cli show cl-1234abcd --html > out.html
# Blame a file — every agent edit in chronological order with line deltas
trajectoriz-cli blame src/main.py
# Aggregate shell-invoked programs across a repo
trajectoriz-cli advanced tools --dir /path/to/repo --json
trajectoriz-cli search raven
# Search backends
trajectoriz-cli search foo --backend grep # in-process substring scan (default)
trajectoriz-cli search foo --backend recoll # Xapian index via recoll CLI
trajectoriz-cli search foo --backend sqlite # local SQLite FTS5 index
# Metadata-only search (no trajectory parsing, much faster)
trajectoriz-cli search foo --fast
# Build / update the recoll and SQLite indexes
trajectoriz-cli refresh # both
trajectoriz-cli refresh --no-sqlite # recoll only
trajectoriz-cli refresh --no-recoll # SQLite only
API
from trajectoriz import iter_records, parse_record
# Iterate sessions across all supported agents (Claude, Codex, Copilot, OpenCode, …)
for record in iter_records():
print(record.agent, record.timestamp[:10], record.first_msg[:60])
# Iterate sessions for the current project only
for record in iter_records(cwd="/path/to/repo"):
trajectory = parse_record(record)
if trajectory is not None:
print(f"{record.agent}: {len(trajectory.steps)} steps, {trajectory.total_tokens} tokens")
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file trajectoriz-0.42.0-py3-none-any.whl.
File metadata
- Download URL: trajectoriz-0.42.0-py3-none-any.whl
- Upload date:
- Size: 35.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
918a687b44d9bb69d5e8715bf57be915add540f44ca687b0d41a95978225bd77
|
|
| MD5 |
0f8f2ccc2545f8ede9cdc48b13b59921
|
|
| BLAKE2b-256 |
eac75e86b29cfc47be88eb59410d2f8ed962dece3834c6f5dcec041c169af4b2
|
Provenance
The following attestation bundles were made for trajectoriz-0.42.0-py3-none-any.whl:
Publisher:
pypi-publish.yml on monperrus/trajectoriz
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
trajectoriz-0.42.0-py3-none-any.whl -
Subject digest:
918a687b44d9bb69d5e8715bf57be915add540f44ca687b0d41a95978225bd77 - Sigstore transparency entry: 2172472129
- Sigstore integration time:
-
Permalink:
monperrus/trajectoriz@acab3341d03550cebafbd841a6683d1aefc03029 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/monperrus
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@acab3341d03550cebafbd841a6683d1aefc03029 -
Trigger Event:
push
-
Statement type:
