Agent Skills
› Chachamaru127/claude-code-harness
› session
session
GitHub统一会话管理技能，支持初始化、记忆持久化、状态控制及跨会话通信。提供列出会话、收件箱检查及广播消息功能。适用于 Claude Code 会话管理，不用于应用登录或认证。
Trigger Scenarios
用户需要查看或管理活跃的 Claude Code 会话
使用 /session 命令进行会话初始化、恢复或跨会话通信
Install
npx skills add Chachamaru127/claude-code-harness --skill session -g -y
SKILL.md
Frontmatter
{
"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."
}
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 |
メモリ最適化（CC 2.1.49+）
Claude Code 2.1.49 以降、セッション再開時のメモリ使用量が 68% 削減 されました。
長時間セッション管理のベストプラクティス
| ワークロード | 推奨戦略 |
|---|---|
| 通常実装 | 1-2時間ごとに --resume で再開 |
| 大規模リファクタ | 機能単位でセッション分割 → 各セッションで --resume |
| 並列タスク | /work all で並列実行、長時間なら途中で --resume |
| メモリ警告時 | 即座に --resume で再開（以前より高速） |
セッション名の自動生成（CC 2.1.41+）
/rename を引数なしで実行すると、会話コンテキストからセッション名を自動生成します。
長時間セッションや --resume を多用するワークフローでセッションの識別が容易になります。
効率的なワークフロー例
# 実装フェーズ1
claude "認証機能を実装"
# → 1時間後
# セッション再開（メモリ効率的）
claude --resume "パスワードリセット機能を追加"
# → 1時間後
# さらに再開
claude --resume "テストを追加"
メモリ管理の推奨事項
| 推奨事項 | 理由 |
|---|---|
| 積極的なセッション再開 | 68% メモリ削減で再開コストが低い |
| 定期的な再開 | コンテキストを整理し、集中力を維持 |
| 機能単位の分割 | 大規模タスクを小さく分けて再開 |
| Plans.md を活用 | 再開時の引き継ぎがスムーズ |
💡 メモリ効率が大幅に改善されたため、セッション再開を積極的に活用してください。
Codex 0.123.0 の session shell / terminal 修正
Codex 0.123.0 では stale proxy env が shell snapshot から復元されにくくなり、VS Code WSL terminal の Unicode / dead-key input と keyboard 入力も本体側で修正されています。 Harness は proxy snapshot scrubber や key input wrapper を追加せず、本体修正を自動継承します。
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.
Version History
- c220671 Current 2026-07-05 14:47
