README
¶
tapes
Transparent agentic telemetry and instrumentation for content-addressable LLM interactions.
About
·
Download
·
Documentation
·
Contributing
tapes is an Agentic telemetry system for content-addressable LLM interactions.
It provides durable storage of agent sessions, plug-and-play OpenTelemetry instrumentation,
and deterministic replay of past agent messages.
📼 Quickstart
Install tapes:
curl -fsSL https://download.tapes.dev/install | bash
Run Ollama and the tapes services. By default, tapes targets embeddings on Ollama
with the embeddinggema:latest model - pull this model with ollama pull embeddinggema:
ollama serve
tapes serve
Start a chat session:
tapes chat --model gemma3
Search conversation turns:
tapes search "What's the weather like in New York?"
Checkout a previous conversation state for context check-pointing and retry:
tapes checkout abc123xyz987
tapes chat
Directories
¶
| Path | Synopsis |
|---|---|
|
Package api provides an HTTP API server for inspecting and managing the Merkle DAG.
|
Package api provides an HTTP API server for inspecting and managing the Merkle DAG. |
|
mcp
Package mcp provides an MCP (Model Context Protocol) server for the Tapes system.
|
Package mcp provides an MCP (Model Context Protocol) server for the Tapes system. |
|
search
Package search provides shared search types and logic for semantic search over stored LLM sessions.
|
Package search provides shared search types and logic for semantic search over stored LLM sessions. |
|
cli
|
|
|
tapes
command
|
|
|
cmd
|
|
|
tapes
Package tapescmder
|
Package tapescmder |
|
tapes/auth
Package authcmder provides the auth command for storing API credentials.
|
Package authcmder provides the auth command for storing API credentials. |
|
tapes/chat
Package chatcmder provides the chat command for interactive LLM chat through the tapes proxy.
|
Package chatcmder provides the chat command for interactive LLM chat through the tapes proxy. |
|
tapes/checkout
Package checkoutcmder provides the checkout subcommand for checking out a point in the conversation DAG.
|
Package checkoutcmder provides the checkout subcommand for checking out a point in the conversation DAG. |
|
tapes/config
Package configcmder provides the config command for managing persistent tapes configuration stored in the .tapes/ directory.
|
Package configcmder provides the config command for managing persistent tapes configuration stored in the .tapes/ directory. |
|
tapes/deck
Package deckcmder provides the deck command for session ROI dashboards.
|
Package deckcmder provides the deck command for session ROI dashboards. |
|
tapes/init
Package initcmder provides the init command for initializing a local .tapes directory in the current working directory.
|
Package initcmder provides the init command for initializing a local .tapes directory in the current working directory. |
|
tapes/inprocessapi
Package inprocessapi provides a shared helper for CLI subcommands that want to talk to the tapes API server over HTTP without requiring an external server.
|
Package inprocessapi provides a shared helper for CLI subcommands that want to talk to the tapes API server over HTTP without requiring an external server. |
|
tapes/search
Package searchcmder provides the search command for semantic search over sessions.
|
Package searchcmder provides the search command for semantic search over sessions. |
|
tapes/serve
Package servecmder provides the serve command with subcommands for running services.
|
Package servecmder provides the serve command with subcommands for running services. |
|
tapes/serve/api
Package apicmder provides the API tapes server cobra command.
|
Package apicmder provides the API tapes server cobra command. |
|
tapes/serve/ingest
Package ingestcmder provides the ingest server cobra command.
|
Package ingestcmder provides the ingest server cobra command. |
|
tapes/serve/proxy
Package proxycmder provides the proxy server command.
|
Package proxycmder provides the proxy server command. |
|
tapes/skill
Package skillcmder provides the `tapes skill` CLI commands for generating, listing, and syncing agent skills from session data.
|
Package skillcmder provides the `tapes skill` CLI commands for generating, listing, and syncing agent skills from session data. |
|
tapes/start
Package startcmder provides the start command for launching tapes and agents.
|
Package startcmder provides the start command for launching tapes and agents. |
|
tapes/status
Package statuscmder provides the status command for displaying the current checkout state of the local .tapes directory.
|
Package statuscmder provides the status command for displaying the current checkout state of the local .tapes directory. |
|
tapes/sync
Package synccmder provides the `tapes sync` CLI command.
|
Package synccmder provides the `tapes sync` CLI command. |
|
tapes/validate
Package validatecmder provides the hidden tapes validate command.
|
Package validatecmder provides the hidden tapes validate command. |
|
tapes/version
Package versioncmder
|
Package versioncmder |
|
Package docs Code generated by swaggo/swag.
|
Package docs Code generated by swaggo/swag. |
|
Package ingest provides an HTTP server that accepts completed LLM conversation turns for storage in the Merkle DAG.
|
Package ingest provides an HTTP server that accepts completed LLM conversation turns for storage in the Merkle DAG. |
|
pkg
|
|
|
backfill
Package backfill extracts token usage from Claude Code transcripts and backfills historical nodes in the tapes database.
|
Package backfill extracts token usage from Claude Code transcripts and backfills historical nodes in the tapes database. |
|
capture
Package capture holds the shared streaming-reduction library consumed by both the local tapes proxy and the cloud tapes-extproc sidecar.
|
Package capture holds the shared streaming-reduction library consumed by both the local tapes proxy and the cloud tapes-extproc sidecar. |
|
cliui
Package cliui provides reusable terminal UI helpers (spinners, step indicators, markdown rendering) for tapes CLI commands.
|
Package cliui provides reusable terminal UI helpers (spinners, step indicators, markdown rendering) for tapes CLI commands. |
|
dotdir
Package dotdir manages the .tapes/ and ~/.tapes directories.
|
Package dotdir manages the .tapes/ and ~/.tapes directories. |
|
embeddings
Package embeddings
|
Package embeddings |
|
embeddings/ollama
Package ollama implements pkg/embedding's Embedder client for Ollama's embedding APIs
|
Package ollama implements pkg/embedding's Embedder client for Ollama's embedding APIs |
|
embeddings/utils
Package embeddingutils is the embeddings utility package
|
Package embeddingutils is the embeddings utility package |
|
git
Package git provides utilities for detecting git repository information.
|
Package git provides utilities for detecting git repository information. |
|
llm
Package llm provides a internal representations of LLM inference API requests and responses which are then further mutated and handled.
|
Package llm provides a internal representations of LLM inference API requests and responses which are then further mutated and handled. |
|
llm/provider/anthropic
Package anthropic
|
Package anthropic |
|
llm/provider/ollama
Package ollama
|
Package ollama |
|
llm/provider/openai
Package openai
|
Package openai |
|
logger
Package logger provides opinionated logging capabilities for the tapes system.
|
Package logger provides opinionated logging capabilities for the tapes system. |
|
merkle
Package merkle is an implementation of a Merkel DAG
|
Package merkle is an implementation of a Merkel DAG |
|
publisher
Package publisher provides interfaces and implementations for publishing Merkle DAG nodes to external event streaming systems.
|
Package publisher provides interfaces and implementations for publishing Merkle DAG nodes to external event streaming systems. |
|
publisher/kafka
Package kafka provides a Kafka-backed Publisher implementation.
|
Package kafka provides a Kafka-backed Publisher implementation. |
|
sessions
Package sessions provides the shared types and logic for building a per-session summary from a chain of merkle nodes.
|
Package sessions provides the shared types and logic for building a per-session summary from a chain of merkle nodes. |
|
skill
Package skill provides LLM-powered extraction of reusable patterns from tapes sessions, outputting Claude Code SKILL.md files.
|
Package skill provides LLM-powered extraction of reusable patterns from tapes sessions, outputting Claude Code SKILL.md files. |
|
sse
Package sse provides a minimal, purpose-built SSE (Server-Sent Events) tee-reader for use in the tapes proxy.
|
Package sse provides a minimal, purpose-built SSE (Server-Sent Events) tee-reader for use in the tapes proxy. |
|
storage
Package storage
|
Package storage |
|
storage/postgres
Package postgres
|
Package postgres |
|
storage/storagetest
Package storagetest provides shared Ginkgo specs that any storage.Driver implementation can run against.
|
Package storagetest provides shared Ginkgo specs that any storage.Driver implementation can run against. |
|
telemetry
Package telemetry provides anonymous usage tracking for the tapes CLI using PostHog.
|
Package telemetry provides anonymous usage tracking for the tapes CLI using PostHog. |
|
update
Package update provides a best-effort mechanism for checking whether a newer version of tapes is available.
|
Package update provides a best-effort mechanism for checking whether a newer version of tapes is available. |
|
utils
Package utils provides bespoke, one off utils that don't make sense to be their own package
|
Package utils provides bespoke, one off utils that don't make sense to be their own package |
|
validate
Package validate walks the parent edges of a tapes store and reports DAG integrity problems: cycles (which cause Ancestry() to loop forever) and dangling parent references (parents pointing at nodes that no longer exist).
|
Package validate walks the parent edges of a tapes store and reports DAG integrity problems: cycles (which cause Ancestry() to loop forever) and dangling parent references (parents pointing at nodes that no longer exist). |
|
vector
Package vector provides interfaces and implementations for vector storage and embedding.
|
Package vector provides interfaces and implementations for vector storage and embedding. |
|
vector/pgvector
Package pgvector provides a PostgreSQL-backed vector driver using the pgvector extension.
|
Package pgvector provides a PostgreSQL-backed vector driver using the pgvector extension. |
|
Package proxy provides an LLM inference proxy that stores conversations in a Merkle DAG.
|
Package proxy provides an LLM inference proxy that stores conversations in a Merkle DAG. |
|
header
Package header provides header filtering for the tapes proxy.
|
Package header provides header filtering for the tapes proxy. |
|
worker
Package worker provides an asynchronous worker pool and utils for persisting conversation turns using the provided storage.Driver and generating embeddings using the provided embeddings.Embedder.
|
Package worker provides an asynchronous worker pool and utils for persisting conversation turns using the provided storage.Driver and generating embeddings using the provided embeddings.Embedder. |
Click to show internal directories.
Click to hide internal directories.