---
title: "Transcript adapter"
description: "A transcript adapter is code that reads one coding agent's session transcripts from disk and turns each session into a common document of turns, working directory, title and files touched."
canonical: "https://agentdrive.sh/glossary/transcript-adapter"
---
# Transcript adapter

> For the complete documentation index, see [llms.txt](https://agentdrive.sh/llms.txt). Every docs page is also served as markdown at its URL plus `.md`, and the full docs are in one file at [llms-full.txt](https://agentdrive.sh/llms-full.txt).

> A transcript adapter is code that reads one coding agent's session transcripts from disk and turns each session into a common document of turns, working directory, title and files touched.

Source: https://agentdrive.sh/glossary/transcript-adapter. Part of the AgentDrive glossary: https://agentdrive.sh/glossary.

Every agent stores sessions in its own format and location, for example Claude Code's JSONL files under `~/.claude/projects/`. An adapter does two things: it finds candidate sessions on disk, and it parses one into the shared shape. Redaction, encryption and upload happen in shared code, so each adapter stays small. Adapters are also called harness adapters.

## In AgentDrive

AgentDrive's adapters live in `packages/mcp-server/src/transcripts/` and serve both `adrive sync` and local mode. Sync adapters for Cline, Zed and Continue do not exist yet and are listed as good first contributions.

## Related terms

- [Session sync](https://agentdrive.sh/glossary/session-sync/index.md): Session sync copies a coding-agent session from the machine it runs on into a shared workspace as it happens, so another agent or another machine can read and resume it.
- [Local mode](https://agentdrive.sh/glossary/local-mode/index.md): Local mode is AgentDrive without an account: the `adrive` CLI reads each agent's transcripts on your machine and builds the handoff brief there, so nothing is uploaded.
- [Coding agent](https://agentdrive.sh/glossary/coding-agent/index.md): A coding agent is an AI tool that works through a software task in a code repository: it reads and edits files, runs commands such as tests, and reports back.

## Go deeper

- [Contributing: harness adapters](https://github.com/agentdrive-sh/agentdrive/blob/main/CONTRIBUTING.md#where-to-start)
- [How background session sync works](https://agentdrive.sh/blog/how-background-session-sync-works)

