docs: add 30-day expiry callout + ship 4 auto-save tools#1391
Merged
Conversation
Adds a brief [!IMPORTANT] callout at the top of the README pointing users to the urgent announcement at #1388. Claude Code auto-deletes local JSONL transcripts after 30 days; users without the auto-save hooks wired are losing transcript data off the rolling window. Ships 4 small standalone tools at tools/: - backup_claude_jsonls.sh — rsync ~/.claude/projects/ to a safe folder - render_jsonl.py — convert JSONL transcripts to readable text - find_orphan_claude_jsonls.sh — scan backup locations for orphan Claude Code transcripts (multi-line shape detection + topic preview) - save.md — Claude Code slash command for manual /save into MemPalace Tools verified by independent agent against v3.3.4 source. Read-only on user data. POSIX bash + Python stdlib only.
Addresses CI lint feedback on PR #1391. No behavior change. - Split `import json, sys` into separate lines (E401) - Split chained `print(...); sys.exit(1)` into two lines (E702, two occurrences) - Split inline `if ts: stamps.append(ts)` into two lines (E701) Verified: `ruff check tools/render_jsonl.py` reports "All checks passed!" Tool still renders correctly (3 turns from a real JSONL test, identical output to pre-fix).
Earlier commit fixed ruff lint but missed the formatter check. This applies `ruff format` — adds standard PEP8 blank lines between functions, splits one inline list. No behavior change. Verified: both `ruff format --check` and `ruff check` pass cleanly. Tool still renders correctly.
Collaborator
Author
|
For context — these are the public surfaces this PR ties into:
The gist has the same 4 tools as this PR's — Milla |
4 tasks
5 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a brief
[!IMPORTANT]callout at the top of the README pointing users to the urgentannouncement at #1388. Claude Code auto-deletes local JSONL transcripts after 30 days; users without
the auto-save hooks wired are losing transcript data off the rolling window.
Ships 4 small standalone tools at
tools/so users can act today without waiting for a release.What's in this PR
README.md — 4 lines added. One
[!IMPORTANT]callout right after the existing scam alert,linking to discussion #1388. Nothing else in the README is touched.
tools/backup_claude_jsonls.sh (39 lines) — rsync
~/.claude/projects/to~/Documents/Claude_JSONL_Backup/. POSIX bash, set -eu, never writes to~/.claude/.tools/render_jsonl.py (71 lines) — convert any JSONL transcript to readable plain text.
Stdlib-only Python 3.9+. Strips tool calls, thinking, system messages.
tools/find_orphan_claude_jsonls.sh (98 lines) — scan iCloud, Dropbox, Google Drive, OneDrive,
Documents, Desktop, Volumes for orphan Claude Code transcripts. Multi-line shape detection (robust
strips "ok so", "oh", "well", "hey", etc.).
tools/save.md — Claude Code slash command for manual
/saveinto MemPalace. Drops into~/.claude/commands/save.mdon the user's machine.Verification
All 4 tools were TDD-verified by an independent agent against the v3.3.4 source:
source)
malformed-line handling, empty input)
iterative leading-filler strip, truncation, case-insensitive, bash 3.2 parse)
against v3.3.4 CLI)
The 30-day retention claim is verified verbatim against the official Anthropic docs at
https://docs.claude.com/en/docs/claude-code/data-usage.
What this does NOT do
mempalace/package)Why now
We launched on April 6 — today is May 6, exactly 30 days. Launch-week JSONLs are at the cliff right
now. Every 24-hour delay = another day of users' transcript data lost off the back end of the
rolling window. The discussion at #1388 covers the full announcement; this PR provides the README
pointer so visitors see it immediately.
Closes/relates to: #1388