Repository navigation
Integrations
Every place Tracekit plugs into an agent, with its status: stable and experimental mean what they mean in what's stable. Every integration keeps the same contract with the signer: how integrations work.
Start with tracekit.instrument(), which wires every framework it finds
installed, or a quickstart. Stable integrations run the adapter contract against the pinned
real library on every push to main and every pull request; each experimental page says what it was tested against.
| Framework | Status | Guide |
|---|---|---|
| OpenAI Agents SDK | Stable | OpenAI Agents |
| LangChain / LangGraph | Stable | LangChain |
| Claude Agent SDK | Stable | Claude Agent SDK |
| MCP client sessions | Stable | MCP |
| Browser Use | Experimental | Browser Use |
| CrewAI | Experimental | CrewAI |
| Pydantic AI | Experimental | Pydantic AI |
| Google ADK | Experimental | Google ADK |
| Strands Agents | Experimental | Strands Agents |
| LlamaIndex | Experimental | LlamaIndex |
| Haystack | Experimental | Haystack |
| Microsoft Agent Framework | Experimental | Microsoft Agent Framework |
| Vercel AI SDK (TypeScript) | Experimental | Vercel AI SDK, TypeScript SDK |
Another agent: record its calls with the SDK's run handle (custom agent).
| Agent | Status | Guide |
|---|---|---|
Claude Code hooks (tracekit init --dev --v2) |
Stable | quickstart |
| The Claude Code plugin | Experimental | plugin |
| Codex CLI, Cursor, Gemini CLI | Experimental | coding agents |
Tracekit doesn't sandbox anything. It records and gates what goes through a sandbox or gateway you already run, from a signer outside it. All of these are experimental, except Claude Code's sandbox rules, which are in the stable coding pack. What each one records: sandboxes, gateways and sensors.
- Sandboxes: NVIDIA OpenShell, agentsh, sandbox-runtime, Claude Code's sandbox, Codex's sandbox, Gemini CLI's sandbox, E2B, microsandbox, Kubernetes agent-sandbox.
- MCP gateways: agentgateway, LiteLLM, Docker MCP Gateway, Wassette.
- Kernel sensors: Tetragon, Falco.
Tracekit's own MCP gateway, LLM gateway, tool executor and egress observer (experimental) record calls out of the agent's process.
- OpenTelemetry (experimental): spans imported as tier T3 evidence, and runs exported as spans.
- Remote clients (experimental): agents on other machines reach the signer over HTTPS with named tokens.
The v1 laptop signer (tracekitd) has its own adapters for any function, LangChain callbacks and MCP client sessions:
adapters (experimental; new agents use the frameworks above). The contrib/ packages build on the v1
path and are experimental too: Causeway, onchain transaction guards,
Stagehand, proof packs and
SQL over the ledger.
Generated from docs/ at v1.4.1. Edit the docs in the repository, not here.
Get started
- Quickstart: the v2 signer
- Quickstarts
- Quickstart: Claude Agent SDK
- Quickstart: a custom agent
- Quickstart: LangChain and LangGraph
- Quickstart: MCP client
- Quickstart: OpenAI Agents SDK
- Coding agents other than Claude Code
- tracekit doctor
- Walkthrough: Tracekit end to end
How it works
- How Tracekit works
- Overview
- The life of a tool call
- The evidence format
- Verification and assurance
- Witnesses and monitoring
- Policy
- Approvals
- Detection and containment
- Capture and completeness
- Custody
- Provenance and tracekit why
- Deployment and isolation
- Storage, durability and performance
- Integrations
- Security model
- Architecture
- tracekit why: architecture
Integrations
- Integrations
- Adapters
- OpenTelemetry
- Remote clients
- Kubernetes agent-sandbox
- agentgateway
- agentsh and Tracekit
- Browser Use
- Claude Agent SDK
- Claude Code's sandbox
- Codex's sandbox
- CrewAI
- Docker MCP Gateway
- E2B
- Falco
- Gemini CLI's sandbox
- Google ADK
- Haystack
- LangChain v1
- LiteLLM
- LlamaIndex
- MCP client
- microsandbox
- Microsoft Agent Framework
- OpenAI Agents SDK
- NVIDIA OpenShell
- Pydantic AI
- sandbox-runtime's proxy on its own
- Strands Agents
- Tetragon
- Vercel AI SDK
- Wassette
Policy and approvals
- Policy reference
- Approvals
- Findings
- Reading the model's reasoning
- Incidents and containment
- Webhooks
Deploy and operate
- Deploying the signer
- The signer as a container
- The signer on Kubernetes
- The compose stack
- Identity
- Tool executor
- MCP gateway
- LLM gateway
- Egress observation
- Witnesses
- Log monitor
- Record-key issuer
- Signer observability
- Viewer
- tracekit why: causal investigation and replay
- Migrating
- Platforms
Verify the evidence
- Reading a v2 verify report
- Evidence format v2
- Auditor guide
- Sample evidence bundle
- Signing
- What Tracekit guarantees
Security and privacy
- Threat model: the v2 signer
- Threat model: the v1 laptop signer
- HTTP security checklist
- Threat-model review packet
- Privacy
- Known limits and trade-offs
- What's stable
Compliance
- Compliance mapping
- EU AI Act
- ISO/IEC 42001
- NIST AI RMF and the Generative AI Profile
- OWASP Top 10 lists for LLM and agentic applications
Evaluation
Demos
- Demos
- Agent approvers within bounds
- Completeness and tamper evidence
- Detection and containment
- Network coverage: an egress observer
- Guardrails: allow, deny, or ask a person
- MCP tools, gated and recorded
- Prompt injection held by provenance
- Why: which input caused the action
Help