SpaceCorps Native CLI Fleet · v1.0.0

Recover & Transfer Claude Desktop Code-Tab Sessions

Switching accounts or organizations shouldn't erase your working history. Recover, inspect, and migrate local Code-tab sessions across accounts in 2 milliseconds.

Install Binary View Source on GitHub Agent Manual (llms.txt)
claude-sessions transfer --dry-run

Engineered for Safety, Speed & Privacy

Built in pure Rust to provide zero-runtime overhead and complete offline data security.

⚡

Sub-Millisecond Execution

Compiled natively to static binaries. Boots up and inspects hundreds of sessions in under 2ms without managed runtime or node overhead.

🛡️

100% Non-Destructive

The CLI strictly performs non-destructive copies. Source profiles, worktrees, and sessions are never modified, moved, or deleted.

🔒

Zero Network & Zero Telemetry

Completely local. Your prompts, code files, and conversation metadata never leave your workstation. No cloud API keys required.

🤖

AI Agent Native

Outputs clean YAML by default or strict JSON with --json. Conforms to stable numeric exit codes for autonomous tool calling.

🔍

Auto-Profile Detection

Automatically determines the signed-in account and active organization from the Claude Desktop config, or accepts prefix overrides.

📦

Cross-Platform

Native precompiled binaries for macOS (Apple Silicon & Intel), Linux (musl static x86_64/arm64), and Windows x64.

Command Reference

Inspect local profiles, query session details, and safely migrate sessions between accounts.

Command Options Description
claude-sessions list --json Discovers all account/org profiles on this workstation, shows session counts, and flags the current active profile.
claude-sessions sessions [ACCOUNT[/ORG]], --json Lists sessions with ID, title, working directory path, archived status, and last activity timestamp.
claude-sessions transfer --dry-run, --skip-archived Transfers sessions from all other profiles into the currently signed-in profile. Safe and idempotent.
claude-sessions transfer --from <ID>, --to <ID> Explicit profile-to-profile session transfer. Supports unambiguous UUID prefixes (e.g. --from 1a2b/3c4d).
claude-sessions agent-readme --json Prints the embedded AI agent operating manual with rules, constraints, and exit code mappings.

How It Works

Understanding on-disk session architecture and the zero-loss migration mechanism.

🍏 macOS
~/Library/Application Support/Claude/claude-code-sessions/<account>/<org>/
🪟 Windows
%APPDATA%\Claude\claude-code-sessions\<account>\<org>\
🐧 Linux
~/.config/Claude/claude-code-sessions/<account>/<org>/
Directory Structure: claude-code-sessions/<account_uuid>/<org_uuid>/ 
claude-code-sessions/<account_uuid>/<org_uuid>/
├── local_<session_uuid>.json   # Session metadata: title, cwd, git branch, updated timestamp
├── deleted_<session_uuid>      # Tombstone marker: prevents restoring user-deleted sessions
└── archived-sessions.idx       # Index of archived session UUIDs
💡

Why Session Transfer Works Seamlessly

Full conversation transcripts, code diffs, and message histories are saved centrally in ~/.claude/projects/ and are shared globally by every account on your computer.

When you run claude-sessions transfer, it copies only the lightweight metadata index files into your active profile. Quit Claude completely (Cmd+Q on macOS) and reopen it: the desktop sidebar immediately links with the on-disk transcripts, bringing all Code-tab sessions back without any cloud re-downloading.

Installation

Install via Cargo or download precompiled standalone release archives.

cargo install --git https://github.com/SpaceCorps/Claude-Sessions-Cli --locked
Operating System Architecture Download Archive
macOS Apple Silicon (aarch64) claude-sessions-v1.0.0-aarch64-apple-darwin.tar.gz
macOS Intel (x86_64) claude-sessions-v1.0.0-x86_64-apple-darwin.tar.gz
Linux x86_64 (musl static) claude-sessions-v1.0.0-x86_64-unknown-linux-musl.tar.gz
Linux ARM64 (musl static) claude-sessions-v1.0.0-aarch64-unknown-linux-musl.tar.gz
Windows x64 (MSVC) claude-sessions-v1.0.0-x86_64-pc-windows-msvc.zip