Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

history.jsonl

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

Your prompt history could be saved to a record store instead of history.jsonl, but nothing uses it yet.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.221.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 149on this box, as of v2.1.308
Written about v2.1.221 first named in a changelog, 3 Aug 2026

In the changelogs

8

Releases whose published page names history.jsonl.

  1. v2.1.300
    History purge message says history.jsonl is rewritten directly on failure

    When purging history, Claude Code's log now says history.jsonl is rewritten directly if replacing its records fails

    found in this entry's text

  2. v2.1.259
    History retention prune rewritten to a two-pass, integrity-verified streaming scan

    History pruning now scans lock-free and verifies the file hasn't changed, deferring the prune instead of erroring if it has.

    found in this entry's text

  3. v2.1.259
    New integrity-checked incremental reader for history.jsonl

    History reads now stream in chunks with a running digest and verify the file wasn't rewritten mid-scan.

    found in this entry's text

  4. v2.1.257
    Optional HIPAA history-retention pruning

    HIPAA-configured organizations get an extra retention pass that prunes stale entries from local history files.

    found in this entry's text, named in this entry

  5. v2.1.257
    History purge now preserves the original file mode

    Purging history now keeps the original file's permission mode instead of writing a fixed one.

    found in this entry's text, named in this entry

  6. v2.1.257
    New locked cleanup path for stray history.jsonl staging copies

    A locked cleanup routine removes stray history staging copies while leaving recently-written ones alone.

    found in this entry's text, named in this entry

  7. v2.1.235
    History purge goes through the storage backend, with a hard refusal when it cannot

    History purge now goes through the storage backend, with a hard error when it can't rewrite safely

    found in this entry's text

  8. v2.1.221
    Prompt history can be written to a record store instead of history.jsonl

    Your prompt history could be saved to a record store instead of history.jsonl, but nothing uses it yet.

    named in this entry, found in this entry's text

First cited

3

The earliest release whose published evidence quoted history.jsonl was v2.1.259, 2 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.2592 Sep 2026History retention prune deferred: history.jsonl changed under the scan
v2.1.2592 Sep 2026history.jsonl was rewritten under the head an earlier scan judged
v2.1.30014 Oct 2026history.jsonl is rewritten directly instead

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.

Feedback