test-claude-resume-sid

Test Claude Code session ID preservation with the --resume flag.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill test-claude-resume-sid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-claude-resume-sid
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/claude-skills/test-claude-resume-sid
Command: npx skills add https://github.com/tankygranny05/agent-box --skill test-claude-resume-sid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the critical need to ensure that Claude Code's session management correctly preserves the Session ID (SID) when resuming a session, preventing unexpected behavior in agent orchestration and management systems.

Core Features & Use Cases

  • Session ID Verification: Tests if the --resume <sid> flag maintains the original SID or forks a new one.
  • Agent Management Debugging: Helps debug issues related to SID-to-PID mapping in agent management servers.
  • Orchestration Readiness: Confirms session continuity before implementing complex agent orchestration.

Quick Start

Run the automated test script located in the scripts directory.

Frequently Asked Questions about test-claude-resume-sid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Does Claude Code --resume flag preserve the original session ID?

Yes, Claude Code's --resume flag preserves the original session ID across multiple processes. This Skill tests SID preservation to confirm session identity persists, preventing unexpected behavior when resuming sessions.

Why do I need to verify session ID preservation for agent orchestration?

You need this session ID verification to debug SID-to-PID mapping issues in agent management servers. It validates that resuming a session maintains identity across processes, which is essential before implementing complex agent orchestration.

How do I test Claude Code session management with tmux?

You can test Claude Code session management by running the automated test script included in the scripts directory. It uses tmux to validate that the session ID is maintained when using the resume flag.

Can I use this to debug SID-to-PID mapping in agent management servers?

This Skill is specifically designed for debugging agent management systems and confirming session identity persistence. It checks if the --resume flag maintains the original SID or forks a new one, ensuring orchestration readiness.

What is the best way to check Claude session continuity before orchestration?

The best way to check session continuity is by running an automated test script that validates SID preservation. This confirms that resuming a Claude session maintains the original session ID across multiple processes.

Do I need tmux to test Claude Code session ID persistence?

The primary limitation is the dependency on tmux, which must be installed in your environment. The Skill focuses strictly on validating session ID preservation and does not perform broader agent orchestration tasks.