Session Skill (Unified)
Consolidates all session-related functionality into one skill.
Usage
bash
/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.
code
📋 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.
code
📬 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.
bash
/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
code
/harness-init
↓
├── Load project context
├── Initialize session.json
├── Load previous session memory (if exists)
└── Display session status
2. Session Control (from /work)
code
/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
code
Session end
↓
├── Extract learnings (gotchas, patterns)
├── Update .claude/memory/*.md
└── Prepare handoff summary
4. Cross-Session Communication
code
/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.