Session
Skill maxwell2732/claudecode-research-harness-workflow/skills/session
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.From its SKILL.md
npx -y skills add maxwell2732/claudecode-research-harness-workflow --skill sessionAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
5.9 KB, as published. Nobody here has run it
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 initializationsession-memory→ Memory persistencesession-control→ Resume/fork controlsession-state→ State management & communication
The individual skills are deprecated but still work for backward compatibility.