session-wrapper
/session-wrapper
Turns a long Claude Code or Codex session, or any pasted chat or ChatGPT/Claude.ai export, into one structured handoff file (goal, decisions in the user's own words, dead ends, key files, last test run, open questions, next steps) that can be pasted into any other model or tool. Reads the log directly with no model and no network, redacts secrets before writing, cites a turn number for every item, and can check later that the handoff still matches the log. Use when the user says hand off, handoff, switching tools or models, the session is getting long or degraded, continue this elsewhere, wrap
- Author
- codegobrrrr9 ↗
- Repository
- session_wrapper ↗
- Licence
- MIT
- Last repository change
- 07.11.2026
Assessment and security
- Files in this package
- 16
- Scripts
- 14
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 14 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/build.js, scripts/check.js, scripts/claude.js, scripts/codex.js, scripts/detect.js, scripts/heur.js, scripts/load.js, scripts/model.js, scripts/output.js, scripts/paths.js, scripts/read.js, scripts/redact.js, scripts/session_wrapper.js, scripts/text.js
What it does and when to use it
Turns a long Claude Code or Codex session, or any pasted chat or ChatGPT/Claude.ai export, into one structured handoff file (goal, decisions in the user's own words, dead ends, key files, last test run, open questions, next steps) that can be pasted into any other model or tool. Reads the log directly with no model and no network, redacts secrets before writing, cites a turn number for every item, and can check later that the handoff still matches the log. Use when the user says hand off, handoff, switching tools or models, the session is getting long or degraded, continue this elsewhere, wrap
Original author description
Turns a long Claude Code or Codex session, or any pasted chat or ChatGPT/Claude.ai export, into one structured handoff file (goal, decisions in the user's own words, dead ends, key files, last test run, open questions, next steps) that can be pasted into any other model or tool. Reads the log directly with no model and no network, redacts secrets before writing, cites a turn number for every item, and can check later that the handoff still matches the log. Use when the user says hand off, handoff, switching tools or models, the session is getting long or degraded, continue this elsewhere, wrap
How it works
- Rules
- Commands
- Final message shape
SKILL.md preview
--- name: session-wrapper description: Turns a long Claude Code or Codex session, or any pasted chat or ChatGPT/Claude.ai export, into one structured handoff file (goal, decisions in the user's own words, dead ends, key files, last test run, open questions, next steps) that can be pasted into any other model or tool. Reads the log directly with no model and no network, redacts secrets before writing, cites a turn number for every item, and can check later that the handoff still matches the log. Use when the user says hand off, handoff, switching tools or models, the session is getting long or degraded, continue this elsewhere, wrap this session, summarise this session for another agent, or /session-wrapper. license: MIT metadata: author: codegobrrrr9 version: "0.1.0" homepage: https://github.com/codegobrrrr9/session_wrapper --- # session-wrapper Long sessions degrade, and switching tools means starting over. session_wrapper reads the session's log from disk and writes the state worth carrying across: what was asked, what the user decided and corrected, what failed and was not fixed, which files changed, the last test run, what is still open. It is extraction, not summarising: the same log gives the same file, it works when your quota is gone, and no value that looks like a secret survives into the file. ## Rules 1. **Run the tool. Do not write the handoff from memory.** A summary written from a long context is the lossy thing this tool exists to avoid. Quote the path and the one-line stats it prints. 2. **Say what it is.** The goal and decisions are quotes and heuristics from the log, labelled "derived". Tell the user to read the file before pasting it anywhere. 3. **A handoff goes to another provider when it is pasted.** Never paste it, send it or upload it yourself. Hand over the file path (or `--copy`) and let the user do it. 4. **Never work around a refusal.** If the tool says it refused because a secret-shaped value survived redaction, report that and stop; do not edit the output to get it through. 5. **Do not read the raw log to improve the handoff.** Run the tool again with a different `--budget`, or run `check` to confirm it still matches the log. 6. Secret detection is heuristic. Say so if the user asks whether the file is safe to share. ## Commands ``` session_wrapper wrap the newest Claude Code session of this folder (writes .session_wrapper/handoffs/) session_wrapper wrap --from codex the newest Codex session started in this folder session_wrapper wrap --session <id> a specific session (id prefix) --all newest anywhere session_wrapper wrap --path chat.json a ChatGPT / Claude.ai export, a transcript, or a log --from stdin read a pasted transcript flags: --budget N (tokens, default 4000) --json --copy --stdout --out <file> --no-cite session_wrapper sessions list recent sessions session_wrapper check <handoff.md> confirm every citation and quote still matches the log ``` How each section is built, what was verified against real logs and what was not: [`references/method.md`](references/method.md). ## Final message shape ``` session_wrapper · wrote .session_wrapper/handoffs/2026-11-08-fix-checkout-webhook.md · 70 prompts, 1,395 tool calls · about 2,300 tokens (estimate) · 5 values redacted Read it first; pasting it sends it to whichever model you paste it into. ```
Files in this package (16)
- SKILL.md 3 KB
- references/method.md 4 KB
- scripts/build.js 17 KB
- scripts/check.js 3 KB
- scripts/claude.js 6 KB
- scripts/codex.js 4 KB
- scripts/detect.js 7 KB
- scripts/heur.js 4 KB
- scripts/load.js 6 KB
- scripts/model.js 2 KB
- scripts/output.js 2 KB
- scripts/paths.js 2 KB
- scripts/read.js 2 KB
- scripts/redact.js 1 KB
- scripts/session_wrapper.js 8 KB
- scripts/text.js 4 KB
Versions
The database has no other skills named session-wrapper.
Database snapshot: 13.11.2026 · package version f6ada54e8c82 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100session-handoff
Use when the user says "session handoff", "wrap up session", "hand off", "handoff summary", or wants a structured end-of-session summary before clearing context. Produces a chat-only handoff covering decisions, shipped changes, key files, running state, verification steps,… - 90handoff
Use when the session ends with work still open or another agent or later session must continue: "handoff", "write it down for the next session", context running out, switching machines. Compacts state, decisions, open questions, changed files, todo status and the next first step… - 100session-handoff
Use when the user says "session handoff", "wrap up session", "hand off", "handoff summary", or wants a structured end-of-session summary before clearing context. Produces a chat-only handoff covering decisions, shipped changes, key files, running state, verification steps,… - 100handoff-writer
把一段长会话整理成 HANDOFF.md,让新会话不读历史就能接手。 当用户说「写个交接」「hand off」「总结上下文给新会话」「收尾」, 或上下文快满了而工作还没做完时使用。 Use when the user asks to write a handoff, wrap up, or summarize context for a new session. - 100session-handoff
Keep long Claude Code sessions from eating usage limits. `write` builds a HANDOFF.md from the session log (files edited, commands run, recent requests, last todo list, git status and recent commits, secrets redacted) with sections Claude fills in (goal, done, decisions, open… - 90handoff
Keep a handoff file so another coding agent (Claude Code, Codex, Kimi Code, Gemini CLI, Cursor) or a later session can continue this task without re-explaining. Use when the user asks to start, update or resume a handoff, says they will switch agents, when…