> ## Documentation Index
> Fetch the complete documentation index at: https://lab.pollack.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Journal 2.0 Overview

> Agent Journal 2.0, the current line on main: one portable OCSF events.jsonl per run, checked against the CLI's native output by an independent oracle

> [!WARNING]
>
> 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](https://ocsf.io) 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?](https://lab.pollack.ai/docs/agent-journal/1x-or-2.md)

## Artifacts

Two artifacts, group `io.github.markpollack`, version `2.0.0-SNAPSHOT`:

| Artifact | What it does | Dependencies |
| - | - | - |
| `journal-ocsf-writer` | Captures a CLI (launching it, reading its standard output, or replaying a recording) and writes the run package | The JDK and `jackson-core` only |
| `journal-capture-tck` | Reads a package, computes the analysis views, and judges a package against its native input with the independent oracle | A reader needs this artifact alone |

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](https://lab.pollack.ai/docs/agent-journal/v2/getting-started.md).

## The package

A run is a package directory:

| File | Holds |
| - | - |
| `events.jsonl` | The run's events on OCSF 1.9.0 with the `agentic_cli` extension |
| `run.json` | The package, recording, run, OCSF version, extension, sources, native files, semantic contract and time policy |

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

> [card] [Getting started](https://lab.pollack.ai/docs/agent-journal/v2/getting-started.md)
>
> Replay a real Claude Code recording into a package and verify it.

> [card] [Capture](https://lab.pollack.ai/docs/agent-journal/v2/capture.md)
>
> `OcsfWriterTool`: launch, capture, replay and assemble.

> [card] [Reading packages](https://lab.pollack.ai/docs/agent-journal/v2/reading.md)
>
> `PackageReader`, `AnalysisViews`, the oracle and `OcsfReaderTool`.

> [card] [CLI support](https://lab.pollack.ai/docs/agent-journal/v2/cli-support.md)
>
> Every CLI and route in the compatibility registry, and what admitted means.

> [card] [Agent Client recording](https://lab.pollack.ai/docs/agent-journal/v2/agent-client.md)
>
> `TerminalReceiver`, terminal profiles and qualifier lookup.

> [card] [Source on GitHub](https://github.com/markpollack/agent-journal)
>
> The default branch is 2.0, the current line.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.