# Compact Plus

> Save the current Claude Code or Codex session state to a temporary state file before running /compact. MANDATORY TRIGGERS: /compact-plus, compact-plus, compact plus, compaction plus handoff, pre-compact state save. DO NOT TRIGGER: post-compact recovery, ordinary progress updates, plan creation, or casual context-usage discussion.

- Skill: `tuyv/compact-plus` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add tuyv/compact-plus`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuyv/compact-plus/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tuyv (https://skillmd.com/u/tuyv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuyv/compact-plus

---


# compact-plus

In Claude Code and Codex, the PreCompact hook automatically saves a pre-compaction state file when `/compact` runs.
This skill is a manual fallback for richer recovery notes.

Before `/compact`, save working state that is not reliably preserved by the compaction summary to the
runtime-specific state directory.

## Strict procedure profile

- Strictness: strict-procedure. The state file content and completion receipt are the deliverable.
- Hard gates: if the session id cannot be detected, do not create a guessed state file name. Stop and report that session id detection failed.
- Forcing function: fix the destination path, then read the saved file back and verify that the required headings exist.
- Completion receipt: report the state file path, main saved items, unverified items, and the instruction to run `/compact`.

## Procedure

1. Get the session id.
   - Use `$CLAUDE_CODE_SESSION_ID` in Claude Code.
   - Otherwise use `$CODEX_THREAD_ID` in Codex.
   - `$CODEX_COMPANION_SESSION_ID` is the final compatibility fallback.
   - If it cannot be detected, do not create a state file. Report that preparation is incomplete because the session id is unavailable.
2. Set the destination.
   - Claude Code: `${TMPDIR:-/tmp}/claude-compact-state/${SESSION_ID}.md`.
   - Codex: `${TMPDIR:-/tmp}/codex-compact-state/${SESSION_ID}.md`.
3. Check TaskList, active plan file, tmux-bridge state, and files currently being edited.
   - Read the relevant active plan file under `~/.claude/plans/` when one is present.
   - If tmux-bridge is not used, record `Not used`.
4. Save the following headings to the state file in this exact order.

```markdown
# Compact Prep State
## Active Plan
## Current Phase
## TaskList Summary
## Session Decisions
## Constraints and Blockers
## Worker Topology
## Skills Invoked
## Editing Files
## Failed Attempts
## Recovery Notes
```

5. Read the state file back after saving and verify that every heading above exists.
6. Tell the user: `Preparation complete. Please run /compact.`

## Content To Save

- Active plan file path and current phase or step.
- In-progress task list and relevant notes.
- Decisions made during the session, user choices, and rejected alternatives with rationale.
- Constraints, blockers, and incomplete verification.
- Worker topology. When tmux-bridge is used, record pane, role, and responsibility.
- Skills and slash commands invoked earlier in the session. This is an invocation record, not proof that the skill or command is currently active.
- Files being edited and notes about unsaved or unverified work.
- Failed attempts, tool errors, and rejected approaches that should not be repeated.
- Recovery notes for the post-compaction agent.

## Completion receipt

Include the following when complete:

- State file path.
- Main saved items.
- Unverified items and reasons.
- `Preparation complete. Please run /compact.`