Context Sync Plugin for Claude Code
English | 简体中文
Save and resume Claude Code session context across multiple windows. Never lose track of your work progress when switching between different projects or tasks.
Features
-
Smart Context Saving: Automatically extracts and saves:
- Completed and pending tasks
- Key files being worked on
- Technical decisions and notes
- Priority-based task organization
-
Easy Session Recovery: Resume previous work sessions with:
- Full context restoration
- Task progress tracking
- Automatic file reference linking
-
Multi-Window Support: Perfect for developers who:
- Work on multiple projects simultaneously
- Need to switch context frequently
- Want to preserve work state across sessions
Installation
From GitHub (Recommended)
# Add the marketplace
/plugin marketplace add Claudate/claude-code-context-sync
# Install the plugin
/plugin install context-sync
Update Plugin (Recommended)
To update the plugin to the latest version (easiest way):
# Simply reload the plugin
/plugin reload context-sync
Or if you want to pull the latest version from GitHub:
# Update to latest version
/plugin update context-sync
Reinstallation (If Already Installed)
If you get an error saying the marketplace is already installed:
# Option 1: Just reload (quickest)
/plugin reload context-sync
# Option 2: Full reinstall (if reload doesn't work)
/plugin marketplace remove context-sync-marketplace
/plugin marketplace add Claudate/claude-code-context-sync
/plugin install context-sync
Local Development
# Clone the repository
git clone https://github.com/Claudate/claude-code-context-sync.git
# Create a development marketplace
mkdir dev-marketplace
cp -r claude-code-context-sync dev-marketplace/
# Install locally in Claude Code
/plugin marketplace add ./dev-marketplace
/plugin install context-sync@dev-marketplace
Usage
Save Current Session
When you need to switch to another task or window:
/save-session
Or simply say:
换窗口处理-
The plugin will:
- Analyze your current work context
- Extract all tasks (completed and pending)
- Save to
docs/context-sessions/YYYYMMDD-HHMM-description.md
Resume Previous Session
In a new window, restore your previous work:
/resume-session
The plugin will:
- Show all available saved sessions
- Let you select which one to resume
- Load the full context and pending tasks
- Help you continue from where you left off
Example Workflow
# Window 1: Working on feature A
> Implementing user authentication...
> /save-session
✅ Context saved: docs/context-sessions/20251210-1430-user-auth.md
# Switch to Window 2: Work on bug fix
> Fixed critical bug in payment flow
> /save-session
✅ Context saved: docs/context-sessions/20251210-1500-payment-bug.md
# Back to Window 1 (or new window)
> /resume-session
📋 Available sessions:
1. 20251210-1430-user-auth.md (3 pending tasks)
2. 20251210-1500-payment-bug.md (1 pending task)
> Select: 1
📂 Loaded session: user-auth
🎯 Continuing with authentication implementation...
Session File Format
Sessions are saved as markdown files in docs/context-sessions/:
# Session: User Authentication Implementation
## 元信息
- **创建时间**: 2025-12-10 14:30
- **状态**: 进行中
## 上下文摘要
Implementing JWT-based authentication with refresh tokens...
## 已完成任务
- [x] Set up JWT library
- [x] Create auth middleware
## 未完成任务
- [ ] 🔴 高优先级: Implement token refresh logic
- [ ] 🟡 中优先级: Add password hashing
- [ ] 🟢 低优先级: Add OAuth integration
## 关键文件
- `backend/auth/jwt.service.ts` - JWT token management
- `backend/middleware/auth.middleware.ts` - Authentication middleware
## 注意事项
- Token expiry set to 1 hour
- Refresh tokens stored in httpOnly cookies
## 下一步行动
1. Review current JWT implementation
2. Add token refresh endpoint
3. Test with Postman
Commands
| Command | Description |
|---|
/save-session | Save current work context |
/resume-session | Resume a previous session |
Skills
This plugin includes two AI skills that Claude can invoke automatically:
context-save
Triggered when you say "换窗口处理-" or use /save-session. Analyzes the conversation and saves structured context.
context-resume
Triggered with /resume-session. Lists available sessions and helps restore work context.
Priority Markers
Tasks are marked with priority indicators:
| Marker | Priority | Use Case |
|---|
| 🔴 | High | Blocking tasks, core features |
| 🟡 | Medium | Important but not urgent |
| 🟢 | Low | Nice-to-have, optimizations |
Requirements
- Claude Code CLI
- Project must have a
docs/ directory (created automatically if missing)
Configuration
No configuration needed! The plugin works out of the box.
Sessions are saved to docs/context-sessions/ by default.
Claudate