Skip to content
Skills Library
Personal productivity · Planning

session

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

Licence
MIT
Last repository change
03.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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.

Arguments

/session [list|inbox|broadcast \"message\"]
Original author 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.

How it works

  1. Usage
  2. Subcommands
  3. Capabilities
  4. Memory Optimization (CC 2.1.49+)
  5. When to Use
  6. Execution Flow
  7. Files Managed
  8. Migration Note
Original SKILL.md headings · 188 lines, 719 words
SKILL.md preview
---
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

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

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

```bash
/session broadcast "Review complete, ready for merge"
```

---

## Capabilities

| Feature | Description | Reference |
|---------|-------------|-----------|
| **Initialization** | Start new session, load context | See [../session-init/SKILL.md](../session-init/SKILL.md) |
| **Memory** | Persist learnings across sessions | See [../session-memory/SKILL.md](../session-memory/SKILL.md) |
| **State Control** | Resume/fork session based on flags | See [references/session-control.md](${CLAUDE_SKILL_DIR}/references/session-control.md) |
| **Communication** | Cross-session messaging | See [../session-state/SKILL.md](../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

```bash
# 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.
Files in this package (3)
  • SKILL.md 6 KB
  • references/session-control.md 1 KB
  • references/state-transition.md 2 KB

Versions

RepositoryScoreLicence
This page · maxwell2732/claudecode-research-harness-workflow100MIT
glassflow/tares100MIT
r3dlex/oh-my-auggie100Apache-2.0
lex0tan/backlog-resume100MIT
rdennler/yat100Apache-2.0
rdennler/thinkpad100Apache-2.0
dotroza/hermes-comfy-recipe96MIT
guillaume-piron-dev/you-decide90Apache-2.0
autocss-com/ai90MIT

Database snapshot: 13.11.2026 · package version 10a43c4ba214 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100sync-claude-sessions
    Sync Claude Code sessions to Obsidian markdown. Export, resume, add notes, close sessions. USE WHEN user says "sync sessions", "export sessions", "resume session", "add session note", "close session", "log session".
  • 98desktop-sessions-discovery
    Discover, search, and selectively restore Claude desktop app sessions hidden across multiple accountIds. Use when user mentions "missing sessions after account switch", "lost desktop sessions", "where do my old sessions live", or runs multiple Claude accounts on the same…
  • 100kk-session-restore
    撤销 kk-sessions 对侧栏做过的改动:按首次使用前存下的快照,把会话标题和所在分区恢复原样,删除 kk-sessions 新建的分区。用户说"撤销 kk-sessions 的改动""恢复会话原样""回滚会话整理""kk-session-restore"时使用,通常在停用或卸载 kk-sessions 之前;卸载后也能用(见「卸载后」)。支持 Claude Code 桌面端和 Codex 桌面端。不删除会话,不移动或删除磁盘上的文件夹。
  • 90loreconvo
    Vault your Claude conversations for cross-session recall. Use this skill when the user asks to "save this session", "vault this", "remember this", "what did we decide about", "load context for", "/vault save", "session history", "find past sessions", "export session", or wants…
  • 100recap
    Show recent Claude Code sessions across all projects, so the user can re-enter work after a reboot or context switch. Lists per session the absolute project path, a short summary, where the session stopped, last activity, turn count, git branch, model, and a ready-to-paste…
  • 100session-management
    Manages Claude Code sessions with naming, checkpointing, and resume strategies. Use when organizing long-running work or resuming across sessions.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.