Skip to content
Skills Library
AI & agents · Conversion & formats

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

Licence
MIT
Last repository change
07.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
16
Scripts
14
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Rules
  2. Commands
  3. Final message shape
Original SKILL.md headings · 37 lines, 404 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.