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 |
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.