Skip to main content
Agent Journal 2.0 is the current Journal line, on main. It is not yet released, and breaking changes are expected before 2.0.0. Checked against markpollack/agent-journal@453c1d1, snapshot 2.0.0-20261108.225512-21.
Agent Journal records an agent CLI’s execution as durable local data: the messages, tool activity, reported usage and cost of a run, written as one independently portable events.jsonl on the OCSF schema with Journal’s agentic_cli extension, and checked against the native input by an independent oracle. 2.0 is a different format from the released 1.x line. Files written by 1.x are read only by 1.x, and there is no upgrade path. See Which Journal do I need?

Artifacts

Two artifacts, group io.github.markpollack, version 2.0.0-SNAPSHOT: A third module in the repository, journal-mcp-test-server, is a test fixture and is not published. The artifacts target Java 17; building the repository needs JDK 21. No 2.0 release exists on Maven Central. A timestamped snapshot is published to the Central snapshot repository on every push to main that changes code; see Getting started.

The package

A run is a package directory: The native sources (the CLI’s stream, session file and so on) are archived whole beside the package; content is never capped. A sub-agent is a child core under children/<id>/ inside the same package, checked like the root. The package kind is agent-journal/ocsf-package, layout 1.0.0 (1.1.0 with a terminal binding). The extension is agentic_cli, uid 901, version 1.0.0; the uid is provisional and not registered with OCSF. A package states its own identifiers. 2.0.0 reads only these 1.0.0 formats: a package written before 2.0.0 is refused as an unsupported format, so read it with the Journal version that wrote it. (Format identifiers checked against markpollack/agent-journal@e161c779.)

Where to go next

Getting started

Replay a real Claude Code recording into a package and verify it.

Capture

OcsfWriterTool: launch, capture, replay and assemble.

Reading packages

PackageReader, AnalysisViews, the oracle and OcsfReaderTool.

CLI support

Every CLI and route in the compatibility registry, and what admitted means.

Agent Client recording

TerminalReceiver, terminal profiles and qualifier lookup.

Source on GitHub

The default branch is 2.0, the current line.