claude-session-manager

Session continuity toolkit for Claude Code and Claude Chat.
Never lose context when a session goes long — save, load, and share session state across your team.

Inspired by Devin AI's session ID pattern. Works with both Claude Code (CLI) and Claude Chat (claude.ai).

Install

npx claude-session-manager init

Or install globally:

npm install -g claude-session-manager
claude-session init

How it works

Devin AI lets you copy a session ID to resume long sessions without losing context. This toolkit replicates that pattern for Claude:

| Devin | Claude Session Manager | |---|---| | Copy session ID | claude-session save | | Paste session ID | claude-session load | | Share session | claude-session share (git push) | | Permanent config | CLAUDE.md (auto-loaded by Claude Code) |

Context is stored in .claude/session-context.json — a structured JSON snapshot of your session state.

Quick start

# 1. Initialise in your project
npx claude-session-manager init

# 2. At the end of a session — save context
claude-session save

# 3. At the start of the next session — load context
claude-session load

# 4. Copy the printed resume prompt into Claude Code or Claude Chat

Commands

claude-session init

Scaffolds everything in your project:

• .claude/ directory
• .claude/session-context.json (empty scaffold)
• .claude/settings.json (hooks config)
• CLAUDE.md (permanent project context)
• .claude/aliases.sh (shell shortcuts)
• Updates .gitignore

claude-session init                # standard setup
claude-session init --team         # enable team sharing (commits session-context.json)
claude-session init --type code    # Claude Code only
claude-session init --type chat    # Claude Chat only

claude-session save

Interactively captures your session state:

• Session summary
• Decisions made
• Work in progress
• Blockers
• Next steps
• Free-form notes

Then prints a ready-to-paste resume prompt.

claude-session save                         # interactive save
claude-session save --commit                # save + git commit
claude-session save -m "end of LP-13157"   # save with commit message

claude-session load

Reads .claude/session-context.json and prints a formatted resume prompt.

claude-session load           # full output for Claude Code
claude-session load --chat    # copyable prompt for Claude Chat (claude.ai)
claude-session load --silent  # raw JSON (for scripting)

Paste the printed prompt as your first message in a new Claude session.

claude-session status

Quick health check — shows what's set up and summarises last saved state.

claude-session status

claude-session share

Commits .claude/session-context.json and CLAUDE.md to git and pushes for team access.

claude-session share
claude-session share -m "EOD handoff for Ravi"

Team members pull and load:

git pull && claude-session load

claude-session template

Interactive CLAUDE.md generator with project-type presets.

claude-session template
claude-session template --type ecommerce

File structure

After init, your project will contain:

your-project/
├── CLAUDE.md                        ← Permanent project context (commit this)
├── .claude/
│   ├── session-context.json         ← Session snapshot (commit if team: true)
│   ├── settings.json                ← Config (gitignored)
│   └── aliases.sh                   ← Shell shortcuts
└── .gitignore                       ← Auto-updated

CLAUDE.md — permanent memory

CLAUDE.md is auto-loaded by Claude Code at the start of every session. It should contain:

• Project overview and tech stack
• Architecture decisions (things that should not change without discussion)
• Conventions and coding standards
• Team member roles
• Off-limits files or patterns

The bootstrap instructions at the bottom tell Claude to auto-load session-context.json on startup — so you get Devin-style resumption automatically.

Team workflow

# Developer A — end of day
claude-session save
claude-session share -m "EOD: LP-13157 in progress, blocked on token refresh"

# Developer B — next morning
git pull
claude-session load
# Paste the printed resume prompt into Claude Code → picks up exactly where A left off

Enable team mode during init to make session-context.json committable:

claude-session init --team

Shell aliases

After init, source the aliases file for one-word shortcuts:

source .claude/aliases.sh

| Alias | Command | |---|---| | cs-save | claude-session save | | cs-load | claude-session load | | cs-status | claude-session status | | cs-share | claude-session share | | cs-resume | claude-session load && claude |

Add to ~/.zshrc or ~/.bashrc for permanent use.

Requirements

• Node.js 18+
• Git (for share command)
• Claude Code (optional — works with Claude Chat too)

Contributing

PRs welcome. Open an issue first for significant changes.

License

MIT