Session audit
Local session memory for Claude Code and Codex—capture context, decisions, artifact references, and next state in Markdown and JSON.
npx -y skills add youkistudios/session-save-system --skill session-auditAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Audit source-attributed Session Save records across Claude Code and Codex, grouped by project, into one local weekly report. Use when the user asks what happened this week, what remains open, or what to do next.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.4 KB, 459 tokens by cl100k_base, as published. Nobody here has run it
Session audit — cross-client bird’s-eye
Resolve this skill directory as SKILL_DIR. Read CLIENT.md beside this file for the active client identity. Read the shared home’s GUIDE.md.
- Run
python3 "$SKILL_DIR/scripts/session_save.py" doctor --client <client_id>. Stop unlessokis true andmigration_requiredis zero. - Run
audit-sources --days 7or the requested window. This returns source-attributed records from every installed client, approved projects, and any unregistered project labels. - Read only each returned
record.json,tag.md, andhuman.mdwhen present. Never read raw transcripts. For every claim retain the source client and record path. - Group only by the returned
approved_projectcanonical name. The kernel may normalize letter case for migrated labels; never merge from punctuation changes, tags, keywords, similar titles, or semantic resemblance. Keep every unregistered label separate under Unregistered project labels, cite its records, and state that no merge was performed. Within approved projects report Verified outcomes, Reported progress, Open / unresolved, High-value assets, and Live threads / pending decisions. Surface dependencies and contradictions rather than silently reconciling them. - Name close-out debt: finished/open records missing
human.mdare not banked knowledge. - Write a complete audit draft to a temporary regular file. Include a five-fact GIST, bottom line, by-project sections, cross-wires, and prioritized next actions. Prefix factual bullets with
[Claude],[Codex], or the returned client ID and link the source record. - Run
write-audit --week <YYYY-Www> --input <draft>to publish atomically intoaudits/global/. Remove the temporary draft. - Print the audit GIST and real output path.
An audit is read-only over source records and the project registry. It may replace the same weekly global report atomically, but it never edits session records, registers/aliases/merges projects, creates project folders, updates a master plan, invents project stages, or erases provenance.