Ante session format
Store and files
Ante (AntigmaLabs/ante) stores sessions under ${ANTE_HOME:-~/.ante}/sessions/<session-id>/
with <session-id> shaped as a ses_<ULID> directory name. DEJA_ANTE_ROOT replaces the
sessions/ directory directly, and DEJA_ANTE_ROOTS adds extra roots. Each session
directory contains:
events.jsonl: append-only event stream written during live runs.meta.json: session metadata (id,provider,model,dir/cwd,
first_user_message, usage, started_time, last_active_time, forked_from).
dialog.json: optional full-conversation snapshot. Whenevents.jsonlexists beside
it, events.jsonl is parsed and dialog.json is treated as a sidecar so deja doctor
does not count it twice; when events.jsonl is absent, parseAnteDialog reads dialog.json.
subagents/<subagent-id>/: nested subagent session directories (Kind: subagent,
unless DEJA_INCLUDE_SUBAGENTS=0).
Records
Each line of events.jsonl is a JSON envelope with timestamp, id, optional parent,
and a tagged event object:
{"timestamp":"2026-08-14T10:00:05Z","id":"evt_02","event":{"UserInput":"Fix the retry timeout in backoff.go"}}
SessionStart: fills missingid,forked_from,provider/model, anddir.UserInput:usermessage; the first line seeds the session title whenmeta.jsonomits it.AgentMessage:assistantmessage.CompactEnd:summaryrecord fromsummary.ShellOutput: bash command (command,exit_code) and optional tool output.ToolStart/ToolEnd:tool_use/ completion status (Success,Failed,Cancelled,
Denied) mapped through the Claude tool dialect for file paths, edit spans, commands,
and exit codes.
UsageUpdate/SessionEnd: token usage counters (falling back tometa.usage).
dialog.json snapshots store reasoning_model and a messages array (role: user
or model/assistant) with content.Text or content.Parts[] (Text, ToolUse, ToolResult).
Wiring and resume
- MCP (
deja install ante): mergesmcp_servers.deja(command+args) into
${ANTE_HOME:-~/.ante}/settings.json, matching Ante's mcp.mdx schema.
- Skills & slash commands: writes
~/.agents/skills/deja-history/SKILL.md. Ante
discovers skills under ~/.agents/skills/ and invokes them as /<skill-name> [args].
- Rules (
deja rules sync): syncs into${ANTE_HOME:-~/.ante}/AGENTS.md(Ante also
falls back to ~/.claude/CLAUDE.md when ~/.ante/AGENTS.md is absent).
- Hooks & status line:
AntigmaLabs/antev0.3.7 exposes no user-configurable
lifecycle hooks (auto: false), and status_line_command in ~/.ante/settings.json
replaces Ante's built-in status bar with no stack_with_default flag, so deja install ante
does not overwrite it.
- Resume & handoff:
deja resumerunsante --resume <id>in the recorded working
directory; deja handoff --to ante --exec runs ante -p <packet>. WriteBack refuses
because events.jsonl and dialog.json belong to an external active format.
Synthetic fixture
fixtures/registry/ante/sessions/ses_01M7WQZKYBJ61WM9H6TR6FP4CY/events.jsonl
and sibling meta.json form the synthetic conformance sample with deterministic IDs and timestamps.
Last verified: 2026-11-20 against AntigmaLabs/ante v0.3.7
deja reads this format and 51 others, and turns what it finds into memory your agents can search. See the harness matrix for what is wired where, or install it and search your own history.
Found this useful? Star deja-vu on GitHub.