Multi-AI Context Manager

VS Code extension for seamless session handoffs between Claude Code, GitHub Copilot, and Claude web.

Stop losing context when switching between AI tools. Capture your session state with one command and resume instantly in any tool with full context restored.

Features

Manual Handoff: Prepare handoff with one keyboard shortcut, switch to any AI tool
Auto-Backup: Automatic backup when token budget approaches limit
Handoff History: Track all past handoffs in your project
Multi-Tool: Works with Claude Code, GitHub Copilot, and Claude web
Local Only: Everything stored locally — no cloud uploads, no privacy concerns
Zero Setup: Install and start using — no configuration required

Quick Start

Install

Open VS Code
Go to Extensions (Cmd+Shift+X)
Search: Multi-AI Context Manager
Click Install

See Installation Guide for detailed setup (Windows, macOS, Linux).

Prepare Handoff

In any AI tool, open Command Palette (Cmd+Shift+P):

Claude: Prepare Handoff

You'll see:

✓ Handoff prepared successfully

Switch Tools & Resume

In your next AI tool (Copilot, Claude web, etc.):

Claude: Resume from Handoff

Automatic context restoration. Start working immediately.

How It Works

1. Prepare Handoff (in Claude Code)

Cmd+Shift+P → Claude: Prepare Handoff

Captures:

Git branch and state
Changed files
Uncommitted changes
Open files and cursor position
Task description
Timestamp

Writes .handoff.json with all context.

2. Commit & Switch

git add .handoff.json
git commit -m "Prepare handoff for Copilot"
# Open GitHub Copilot

3. Resume (in Copilot)

Cmd+Shift+P → Claude: Resume from Handoff

Extension auto-detects .handoff.json and generates resumption prompt. Copy to Copilot chat.

4. Full Context Restored

Copilot sees:

Branch: feature/auth
Task: Implement JWT validation
Files: auth.ts, middleware.ts, tests.ts
Recent changes: Line-by-line diff
What you were doing: Full context prompt

Workflows

Workflow 1: Token Budget Limit

You're in Claude Code approaching token limit.

Step 1: Auto-Backup (Optional)

If token budget hits 70%:

⚠️ Token budget approaching limit. Auto-backup prepared.

Or manually prepare:

Cmd+Shift+P → Claude: Prepare Handoff

Step 2: Commit & Switch

git add .handoff.json
git commit -m "Prepare handoff"
# Open GitHub Copilot

Step 3: Resume

Cmd+Shift+P → Claude: Resume from Handoff

Step 4: Continue Work

You're back with full context. Copilot understands what you were doing.

Workflow 2: Multi-Day Feature

Complex feature spanning multiple days and tools.

Day 1, 10am: Claude Code

Cmd+Shift+P → Claude: Prepare Handoff
  "Design authentication schema"

Day 1, 3pm: Switch to Copilot

Resume → Continue implementation
Prepare Handoff
  "Implement JWT middleware"

Day 2, 10am: Back to Claude Code

Resume → Continue testing
View Handoff History

See all sessions and jump back to any point.

Workflow 3: Context Review

Before complex debugging, capture context for reference.

Cmd+Shift+P → Claude: Prepare Handoff
  "Debugging payment transaction flow"

View Handoff History
→ See all debugging sessions
→ Easily compare different attempts

Commands

Open Command Palette (Cmd+Shift+P) and type:

Claude: Prepare Handoff

Capture current session state.

Cmd+Shift+P → Claude: Prepare Handoff

Creates .handoff.json with full context.

Claude: Show Handoff History

View all past handoffs in project.

Cmd+Shift+P → Claude: Show Handoff History

Shows:

2026-05-17 14:32  feature/auth      "Implement JWT validation"
2026-05-17 12:15  feature/auth      "Add token refresh logic"
2026-05-17 09:45  feature/auth      "Review tests"
2026-05-16 16:30  bugfix/payment    "Fix transaction limits"

Claude: Resume from Handoff

Load handoff and copy resumption prompt.

Cmd+Shift+P → Claude: Resume from Handoff

Copies full context to clipboard. Paste into next tool.

Settings

Configure extension behavior. Open VS Code Settings (Cmd+,):

Token Threshold

handoff.tokenThreshold (default: 70)

Auto-backup when token budget hits X%.

{
  "handoff.tokenThreshold": 80
}

Auto-Backup

handoff.autoBackupEnabled (default: true)

Automatic backup on token threshold.

{
  "handoff.autoBackupEnabled": false
}

Telemetry

handoff.telemetryEnabled (default: true)

Send anonymous usage statistics (optional).

{
  "handoff.telemetryEnabled": false
}

Exclude Patterns

handoff.excludePatterns (default: [".env*", "secrets/", ...])

Files to exclude from handoff.

{
  "handoff.excludePatterns": [
    ".env*",
    "secrets/",
    "*.log",
    "node_modules/",
    ".git/"
  ]
}

What Gets Captured

Each handoff includes:

{
  "timestamp": "2026-05-17T14:32:00Z",
  "branch": "feature/auth",
  "task": "Implement JWT validation",
  "changedFiles": ["auth.ts", "middleware.ts", "tests.ts"],
  "uncommittedChanges": {
    "auth.ts": { "additions": 15, "deletions": 3 }
  },
  "stagedFiles": ["auth.ts"],
  "openFiles": [
    { "path": "auth.ts", "line": 42 }
  ],
  "tool": "claude-code",
  "reason": "token-limit"
}

Examples

Example 1: Simple Handoff

You're fixing a bug in auth.ts but need to switch to Copilot for focused review.

In Claude Code:

Cmd+Shift+P → Claude: Prepare Handoff
  "Fix auth token expiry validation"

In Copilot:

Cmd+Shift+P → Claude: Resume from Handoff
→ Paste into chat
→ Copilot sees the exact code and issue
→ Continue debugging with full context

Example 2: Auto-Backup Trigger

Working on authentication. Token budget rises to 75%.

Extension shows:

⚠️ Token budget approaching limit. Auto-backup prepared.

No action needed. When you're ready, manually resume:

Cmd+Shift+P → Claude: Resume from Handoff

Example 3: Handoff History Review

You worked on payment feature 3 days ago. Want to continue.

Cmd+Shift+P → Claude: Show Handoff History

See all payment-related sessions:

2026-05-15 16:30  bugfix/payment    "Fix transaction limits"
2026-05-15 14:00  bugfix/payment    "Add payment retry logic"
2026-05-14 10:20  bugfix/payment    "Design payment flow"

Pick any session and resume with that exact context.

Integration

With @thetrueguardai/core CLI

This extension uses @thetrueguardai/core CLI for file operations. Both work together:

Extension: VS Code UI commands CLI: Terminal commands

Example combined workflow:

# Terminal: View history
handoff-core history --branch feature/auth

# VS Code: Resume specific handoff
Cmd+Shift+P → Claude: Resume from Handoff

See @thetrueguardai/core documentation for CLI details.

Troubleshooting

"command not found: handoff-core"

The CLI isn't installed. Fix:

npm install -g @thetrueguardai/core

Restart VS Code.

Extension doesn't show commands

Ensure you're in a git repository
Restart VS Code (Cmd+R)
Check installation in Extensions (Cmd+Shift+X)

Handoff not prepared

Check git status: git status
Ensure you have write permissions
Try terminal: handoff-core prepare

History shows nothing

Create a handoff first: Cmd+Shift+P → Claude: Prepare Handoff
Check .claude/handoff-history.json exists

Auto-backup not triggering

Check setting: handoff.autoBackupEnabled is true
Verify token threshold: Default is 70%
Monitor token budget in Claude Code

Best Practices

1. Use Descriptive Tasks

Instead of:

Cmd+Shift+P → Claude: Prepare Handoff
  (leave blank)

Use:

Cmd+Shift+P → Claude: Prepare Handoff
  "Fix JWT token expiry validation in auth.ts"

This makes history searchable and context clear.

2. Commit Handoff Files

Always commit .handoff.json:

git add .handoff.json
git commit -m "Prepare handoff for [tool]"

This preserves history and allows team handoffs.

3. Review Before Switching

Before switching tools, review the handoff:

Cmd+Shift+P → Claude: Show Handoff History

Ensure you're resuming the right context.

4. Use Auto-Backup

Leave handoff.autoBackupEnabled: true (default). Automatic backup prevents context loss.

5. Clean Old Handoffs

Terminal (optional):

handoff-core clean --days 30

Keeps history manageable.

Privacy & Security

Local Only: All handoffs stored locally in .claude/
No Cloud: No external services, no uploads
Git Safe: Handoff files can be safely committed and pushed
Excludable: Configure patterns to exclude sensitive files

Default exclusions:

.env* — environment variables
secrets/ — secret files
*.log — log files
node_modules/ — dependencies

Requirements

VS Code 1.85+
Node.js 16+ (for CLI)
@thetrueguardai/core installed globally

See Installation Guide for setup.

Development

This extension is built with:

TypeScript
VS Code Extension API
@thetrueguardai/core library

For development setup, see project repository.

License

MIT

Support

Documentation: See Usage Guide
Issues: GitHub Issues
CLI Help: handoff-core --help

Multi-AI Context Manager

family-first-dev

Multi-AI Context Manager

Features

Quick Start

Install

Prepare Handoff

Switch Tools & Resume

How It Works

1. Prepare Handoff (in Claude Code)

2. Commit & Switch

3. Resume (in Copilot)

4. Full Context Restored

Workflows

Workflow 1: Token Budget Limit

Workflow 2: Multi-Day Feature

Workflow 3: Context Review

Commands

Claude: Prepare Handoff

Claude: Show Handoff History

Claude: Resume from Handoff

Settings

Token Threshold

Auto-Backup

Telemetry

Exclude Patterns

What Gets Captured

Examples

Example 1: Simple Handoff

Example 2: Auto-Backup Trigger

Example 3: Handoff History Review

Integration

With @thetrueguardai/core CLI

Troubleshooting

"command not found: handoff-core"

Extension doesn't show commands

Handoff not prepared

History shows nothing

Auto-backup not triggering

Best Practices

1. Use Descriptive Tasks

2. Commit Handoff Files

3. Review Before Switching

4. Use Auto-Backup

5. Clean Old Handoffs

Privacy & Security

Requirements

Development

License

Support