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.8

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.8
File Size Uploaded Provenance Actions
thrdi-0.2.8.tar.gz 4.0 MB With provenance Details for thrdi-0.2.8.tar.gz

Built distribution (wheel)

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

Total release size: 4.5 MB

Release files / thrdi-0.2.8.tar.gz

Download URL thrdi-0.2.8.tar.gz
Size 4.0 MB
Tags Source
SHA-256 checksum
How to use checksums
e00b74d5840858952524f59d6ec3a0a66cb5e1567655cf855defd52e7b1f17a5
BLAKE2b-256 checksum
How to use checksums
85579cf39c43c00d8f8b411a1dd2f702f93799a87aa25dc75818bfafe6634655
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 Nov 4, 2026.

Transparency log

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

Download URL thrdi-0.2.8-py3-none-any.whl
Size 502.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c38a4df8021fbe8299220366d01531b7102baed61889d789f8656ef20a1555f
BLAKE2b-256 checksum
How to use checksums
1905d9ae688388ed6b7332eae01154eb528412cb0aaa495984e6706698742544
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 Nov 4, 2026.

Transparency log

Security for thrdi 0.2.8

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.8.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 Nov 4, 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.8 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