session

name	session
description	Unified session management window. Handles initialization, memory, state all-in-one. Explicit /session invocation only — sub-skills handle auto-delegation. Use when managing Claude Code sessions, /session command. Do NOT load for: app user sessions, login state, authentication features.
description-en	Unified session management window. Handles initialization, memory, state all-in-one. Explicit /session invocation only — sub-skills handle auto-delegation. Use when managing Claude Code sessions, /session command. Do NOT load for: app user sessions, login state, authentication features.
allowed-tools	["Read","Bash","Write","Edit","Glob"]
user-invocable	true
disable-model-invocation	true
argument-hint	[list|inbox|broadcast "message"]

Session Skill (Unified)

Consolidates all session-related functionality into one skill.

Usage

/session              # Show available options
/session list         # Show active sessions
/session inbox        # Check incoming messages
/session broadcast "message"  # Send message to all sessions

Subcommands

/session list - List Active Sessions

Shows all active Claude Code sessions in the current project.

📋 Active Sessions

| Session ID | Status | Last Activity |
|------------|--------|---------------|
| abc123     | active | 2 min ago     |
| def456     | idle   | 15 min ago    |

/session inbox - Check Inbox

Checks for incoming messages from other sessions.

📬 Session Inbox

| From | Time | Message |
|------|------|---------|
| abc123 | 5m ago | "Ready for review" |
| def456 | 10m ago | "API implementation done" |

/session broadcast "message" - Broadcast Message

Sends a message to all active sessions.

/session broadcast "Review complete, ready for merge"

---

Capabilities

Feature	Description	Reference
Initialization	Start new session, load context	See ../session-init/SKILL.md
Memory	Persist learnings across sessions	See ../session-memory/SKILL.md
State Control	Resume/fork session based on flags	See references/session-control.md
Communication	Cross-session messaging	See ../session-state/SKILL.md

---

Memory Optimization (CC 2.1.49+)

From Claude Code 2.1.49 onward, memory usage when resuming sessions has been reduced by 68%.

Best Practices for Long Session Management

Workload	Recommended Strategy
Normal implementation	Resume with --resume every 1–2 hours
Large-scale refactoring	Split by feature unit → use --resume per session
Parallel tasks	Run in parallel with /work all; use --resume for long sessions
On memory warning	Immediately resume with --resume (faster than before)

Automatic Session Naming (CC 2.1.41+)

Running /rename without arguments automatically generates a session name from the conversation context. Makes session identification easier in workflows that involve long sessions or frequent --resume.

Efficient Workflow Example

# Implementation phase 1
claude "Implement authentication"
# → 1 hour later

# Resume session (memory-efficient)
claude --resume "Add password reset feature"
# → 1 hour later

# Resume again
claude --resume "Add tests"

Memory Management Recommendations

Recommendation	Reason
Actively resume sessions	68% memory reduction makes resuming cheap
Resume periodically	Organizes context and maintains focus
Split by feature unit	Break large tasks into smaller resumable chunks
Leverage Plans.md	Smooth handoff on resume

Memory efficiency has greatly improved — actively leverage session resumption.

Codex 0.123.0 session shell / terminal Fix

In Codex 0.123.0, stale proxy env is less likely to be restored from the shell snapshot, and Unicode / dead-key input in VS Code WSL terminal and keyboard input have been fixed in the main binary. The harness does not add a proxy snapshot scrubber or key input wrapper — it inherits the main binary fixes automatically.

---

When to Use

• Session initialization (/harness-init)
• Session resume/fork (/work --resume, /work --fork)
• Memory persistence (automatic)
• Cross-session communication (/session broadcast)

Execution Flow

1. Session Initialization

/harness-init
    ↓
├── Load project context
├── Initialize session.json
├── Load previous session memory (if exists)
└── Display session status

2. Session Control (from /work)

/work --resume
    ↓
├── Check session.json exists
├── Load session state
└── Continue from last checkpoint

/work --fork
    ↓
├── Create new session branch
├── Copy relevant context
└── Start fresh with context

3. Memory Persistence

Session end
    ↓
├── Extract learnings (gotchas, patterns)
├── Update .claude/memory/*.md
└── Prepare handoff summary

4. Cross-Session Communication

/session broadcast "message"
    ↓
├── Find active sessions
├── Write to session.events.jsonl
└── Notify all sessions

Files Managed

File	Purpose
.claude/state/session.json	Current session state
.claude/state/session.events.jsonl	Event log for cross-session communication
.claude/memory/*.md	Persistent memory files

Migration Note

This skill consolidates:

• session-init → Session initialization
• session-memory → Memory persistence
• session-control → Resume/fork control
• session-state → State management & communication

The individual skills are deprecated but still work for backward compatibility.