agtrace 0.1.15

agtrace provides a unified timeline and analysis layer for fragmented AI agent logs. Use the CLI for instant visualization, or build custom monitoring tools with the SDK.

🌟 Core Value

1. Universal Normalization: Converts diverse provider logs (Claude, Gemini, etc.) into a standard AgentEvent model.
2. Schema-on-Read: Resilient to provider updates. No database migrations needed.
3. Local-First: 100% offline. Privacy by design.

🚀 Quick Start (CLI)

The reference implementation of the agtrace platform.

npm install -g @lanegrid/agtrace
cd my-project
agtrace init      # initialize workspace (~/.agtrace)
agtrace watch     # live dashboard

🛠️ Building with the SDK

Embed agent observability into your own tools (vital-checkers, IDE plugins, dashboards).

[dependencies]
agtrace-sdk = "0.1"

use agtrace_sdk::{Client, Lens};

// Connect to the local workspace
let client = Client::connect("~/.agtrace")?;

// 1. Real-time Monitoring
for event in client.watch().all_providers().start()? {
    println!("Activity: {:?}", event);
}

// 2. Session Diagnosis
let session_handle = client.sessions().get("session_123")?;
let report = session_handle.analyze()?
    .through(Lens::Failures)
    .through(Lens::Loops)
    .report()?;
println!("Health: {}", report.score);

📚 Documentation

• Why agtrace? - Understanding the problem and solution
• Getting Started - Detailed installation and usage guide
• Architecture - Platform design and principles
• SDK Documentation - Building custom tools
• Full Documentation - Commands, FAQs, and more

🔌 Supported Providers

• Claude Code (Anthropic)
• Codex (OpenAI)
• Gemini (Google)

📦 Architecture

graph TD
    CLI[agtrace-cli] --> SDK[agtrace-sdk]
    YourApp[Your Tool] --> SDK
    SDK --> Core[Core Engine & Providers]

• Core SDK: agtrace-sdk, agtrace-engine, agtrace-providers
• Applications: agtrace-cli (Reference Implementation)

License

Dual-licensed under the MIT and Apache 2.0 licenses.