cd /news/developer-tools/jsonl-transcript-source-of-truth · home topics developer-tools article
[ARTICLE · art-33359] src=signetai.sh ↗ pub= topic=developer-tools verified=true sentiment=· neutral

JSONL Transcript Source of Truth

Signet has adopted JSONL as the canonical transcript format, stored at `memory/{harness}/transcripts/transcript.jsonl`, to serve as the source of truth for transcript-based summary, fallback, and lineage flows. The daemon normalizes transcripts from hooks, live sessions, or legacy artifacts into a unified schema, supporting multiple agents without relying on any single harness's native log format. This change makes JSONL the primary persistence target, with markdown artifacts and database tables retained only for backward compatibility.

read1 min views1 publishedJun 18, 2026

Signet stores transcripts as JSONL under the workspace at memory/{harness}/transcripts/transcript.jsonl

. The file is appendable during live sessions, easy to copy from harnesses that already persist JSONL, and stable enough to become the input for transcript-based summary, fallback, and lineage flows.

The daemon accepts three transcript sources. If a hook provides a transcript path or inline transcript, the daemon normalizes the conversation into canonical JSONL records and replaces the prior slice for that agent, harness, and session. If a harness only calls prompt-submit with the current user turn, the daemon appends live user and previous-assistant turns so active sessions still appear before session-end. If an existing install only has legacy markdown artifacts or database transcript rows, the daemon backfills those records into the same JSONL location before new writes.

The canonical record schema is signet.transcript.v1

. Each line carries the agent id, harness id, session key/id, project, sequence number, role, content, capture timestamp, source format, optional source path, and source hash. This keeps one transcript substrate across Claude Code, Codex, OpenCode, OpenClaw, Hermes Agent, Gemini, Oh My Pi, and Pi without relying on any one harness’s native log shape.

Markdown transcript artifacts remain readable as legacy inputs, and the session_transcripts

table remains a compatibility/indexing surface while existing retrieval and FTS paths migrate. New transcript persistence must write JSONL first and treat markdown transcript artifacts as historical compatibility, not the forward source of truth.

── more in #developer-tools 4 stories · sorted by recency
── more on @signet 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/jsonl-transcript-sou…] indexed:0 read:1min 2026-06-18 ·