Session memory for Claude Code.
Captures decisions, timelines, and patterns across sessions. Makes context recoverable after /compact.

Why?

Claude Code sessions are ephemeral. When you /compact or start fresh, your reasoning, decisions, and progress disappear. Session Copilot captures all of that and makes it recoverable.

This plugin only works in Claude Code — it depends on PostToolUse hooks, skills, resource notifications, and CLAUDE.md context injection that no other MCP client has.

Quick Start

npx @mcptoolshop/claude-session-copilot

Claude Code Plugin

Add to your project's .mcp.json:

{
  "mcpServers": {
    "session-copilot": {
      "command": "npx",
      "args": ["-y", "@mcptoolshop/claude-session-copilot"]
    }
  }
}

What It Does

7 Tools

Tool	Purpose
`copilot.decision`	Log a decision (what, why, alternatives rejected)
`copilot.snapshot`	Save session state for continuity
`copilot.resume`	Load latest snapshot + decisions for a new session
`copilot.timeline_event`	Record a timeline event
`copilot.query`	Search decisions/timeline/snapshots
`copilot.pulse`	Project health dashboard
`copilot.forget`	Prune old data

4 Skills (Claude Code only)

Skill	What it does
`/copilot:resume`	Pick up where the last session left off
`/copilot:snapshot`	Save comprehensive state before `/compact`
`/copilot:decisions`	Review the decision log
`/copilot:pulse`	Project health dashboard

4 PostToolUse Hooks (Claude Code only)

Auto-record to the timeline after:

Bash — detects build/test results (pass/fail)
Write — records file creation
Edit — records file modification
TodoWrite — records task state changes

Pattern Detection

Surfaces alerts when it notices:

Repeated failure — same command fails 3+ times
File churn — same file edited 5+ times in one session
Long session — 100+ events without a snapshot

4 Resources

URI	What it shows
`copilot://pulse`	Live project health
`copilot://timeline`	Current session events
`copilot://decisions`	Recent decision log
`copilot://snapshot/latest`	Most recent handoff note

Session Lifecycle

┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐
│ Session Start│ ──► │  /copilot:resume  │ ──► │   Work normally  │
└─────────────┘     └──────────────────┘     │  (hooks auto-    │
                                              │   track events)  │
                                              └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │ copilot.decision │
                                              │ (log key choices)│
                                              └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │/copilot:snapshot │
                                              │ (before /compact)│
                                              └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │  Next session    │
                                              │  /copilot:resume │
                                              └─────────────────┘

Storage

Data persists in .claude/copilot/store.json (project-local) or ~/.claude/copilot/store.json (global fallback).

Override with COPILOT_STORE_PATH environment variable.

Why Claude Code Only?

This server is architecturally dependent on Claude Code primitives:

Feature	Claude Code Primitive	Other MCP Clients
Auto-timeline	PostToolUse hooks	No hooks system
Slash commands	Skills (SKILL.md)	No skills
Context injection	CLAUDE.md	No equivalent
Live dashboards	Resource notifications	Don't poll resources
Task coordination	TodoWrite hooks	No TodoWrite

Without these, the server is just a JSON file with no way to populate it automatically.

License

MIT

Built by MCP Tool Shop

@mcptoolshop/claude-session-copilot

Quick Install