Skip to main content

thirdeye

PyPI Homebrew CI codecov Python License

Trace every agent session on your machine — Claude Code, Codex, Cursor, Copilot — into one history you and your agents can manage, search, and evaluate.

Thirdeye persists each session as a durable, append-only local event history. Prompts, responses, tool calls, subagents, usage, and session metadata remain available after the original agent process exits, giving both people and agents a consistent record to inspect. Connect thirdeye to Pydantic Logfire to make full use of that tracing data: explore complete execution trees, investigate individual turns, and analyze behavior across sessions.

Visit third3y3.com for guides and the full command reference.

Installation

Homebrew is the simplest option on macOS and Linux. On Windows, use pipx or uv.

brew install duncankmckinnon/tap/thirdeye

Alternatively, install with pipx:

pipx install thrdi

Or use uv or pip:

uv tool install thrdi
pip install thrdi

Setup

Run the guided setup after installation:

thirdeye setup

The setup flow:

  1. Selects the agent integrations you want to trace.
  2. Installs the required hooks or agent configuration.
  3. Offers to install thirdeye's bundled skills in the matching agent directories.
  4. Optionally connects Pydantic Logfire and saves the write token used for export.

You can rerun setup whenever you add an agent or change your Logfire configuration.

Logfire

Pydantic Logfire is where thirdeye's captured data becomes a full observability experience. Once connected during setup, each session appears as an OpenTelemetry trace containing agent turns, model calls, tool executions, subagents, and available token usage and attributed costs. Use Logfire to navigate the complete execution flow, query across sessions, compare agent behavior, and investigate where time and tokens were spent.

Export happens outside the agent hook, so network latency does not interrupt the agent session.

See third3y3.com for Logfire configuration and export details.

Skills

Thirdeye includes focused skills that let coding agents work directly with the history it captures:

  • use-thirdeye — inspect sessions, search events, debug tool calls, and analyze captured usage.
  • thirdeye-evals — create evaluation rubrics, run evaluators, and interpret per-turn findings.
  • thirdeye-review — audit agent behavior for inefficiencies and recommend concrete invocation or skill improvements.
  • thirdeye-filter — translate natural-language questions from the UI into structured session and turn filters.
  • thirdeye-logfire — configure, verify, and troubleshoot thirdeye's Logfire integration.

The setup flow can install these for you. To add them later, run thirdeye skills add; use thirdeye skills list to see what is available.

Contributing

Contributions are welcome. See CONTRIBUTING.md for local development, validation, and pull-request guidance.

Metadata

Release files for thrdi 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for thrdi 0.2.6
File Size Uploaded Provenance Actions
thrdi-0.2.6.tar.gz 4.0 MB With provenance Details for thrdi-0.2.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for thrdi 0.2.6
File Interpreter ABI Platform Actions
thrdi-0.2.6-py3-none-any.whl Python 3 none any Details for thrdi-0.2.6-py3-none-any.whl

Total release size: 4.5 MB

Release files / thrdi-0.2.6.tar.gz

Download URL thrdi-0.2.6.tar.gz
Size 4.0 MB
Tags Source
SHA-256 checksum
How to use checksums
ed93b680e9c0cf5c09740c64e6d28188268e7ea8bf33d9159872f6bd182284f7
BLAKE2b-256 checksum
How to use checksums
48c05f11bc42800e1dfab168a27a670829a88285ee8620bf845f022a4791c714
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / thrdi-0.2.6-py3-none-any.whl

Download URL thrdi-0.2.6-py3-none-any.whl
Size 500.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c5379d36619b8d96beb2aafd322478af90b295f1f103f13136c723ff8d52188
BLAKE2b-256 checksum
How to use checksums
f22bbdd2eb03bff971bf12f8b5e2e9ed4fba5bc0a517c6aab541297288da2eb2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for thrdi 0.2.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for thrdi-0.2.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.6 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page