| name | SaveContext-MCP |
| description | Persistent memory for AI coding agents via MCP tools. USE WHEN user says "save context", "remember this", "checkpoint", "resume session", "prepare for compaction", "wrap up", OR when starting work on a project that may span sessions. |
SaveContext (MCP)
Save decisions, track progress, and maintain continuity across coding sessions.
Critical Rules
NEVER use context_session_start when the user says "resume". The word "resume" (or "continue session", "pick up where I left off") ALWAYS means:
context_list_sessions to find the sessioncontext_session_resume to resume it
context_session_start creates NEW sessions. It has limited auto-resume that only works for active sessions on the exact same project path. Using it to "resume" almost always creates duplicates.
Quick Actions
For most requests, use these patterns directly:
| User Says | Do This |
|---|
| "save this decision" | context_save key="..." value="..." category="decision" |
| "remember this" | context_save key="..." value="..." category="note" |
| "checkpoint" | context_checkpoint name="..." |
| "wrap up" | See WrapUp workflow |
| "resume [topic]" | MUST search sessions, then context_session_resume |
| "start session" / "begin work" | context_session_start (new sessions only) |
Context Injection
Use context_prime to get full project awareness in a single call.
context_prime() # Full context dump
context_prime(smart=true) # Relevance-ranked within token budget
context_prime(smart=true, budget=2000) # Custom token budget
context_prime(smart=true, query="authentication") # Boost auth-related items
context_prime(smart=true, decay_days=7) # Aggressive recency bias
Smart mode scores items by temporal_decay * priority * category * semantic_boost, applies MMR diversity re-ranking, and packs into the token budget.
Workflow Routing
| Workflow | Trigger | File |
|---|
| QuickSave | "save", "remember", "note this" | Workflows/QuickSave.md |
| SessionStart | Starting work, "begin session" | Workflows/SessionStart.md |
| WrapUp | "wrap up", "end of day", "checkpoint everything" | Workflows/WrapUp.md |
| Resume | "resume", "continue", "pick up where I left off" | Workflows/Resume.md |
| Compaction | "prepare for compaction", context getting long | Workflows/Compaction.md |
| IssueTracking | "create issue", "track this bug" | Workflows/IssueTracking.md |
| Planning | "plan this feature" | Workflows/Planning.md |
| FeatureLifecycle | "implement", "build this", "plan and execute" | Workflows/FeatureLifecycle.md |
| Advanced | Multi-day projects, multi-agent, branch switching, subagents | Workflows/AdvancedWorkflows.md |
Examples
Example 1: Quick save during work
User: "remember that we chose JWT over sessions for auth"
→ context_save key="auth-decision" value="Chose JWT over sessions for stateless scaling" category="decision" priority="high"
→ Saved. No session management needed.
Example 2: Starting a work session
User: "let's work on the payment feature"
→ context_session_start name="payment-feature" description="Implementing Stripe integration"
→ Session started (or resumed if exists)
Example 3: Wrapping up
User: "wrap up for today"
→ Invokes WrapUp workflow
→ Saves progress, creates checkpoint, pauses session
Do NOT Automatically
- Start sessions for quick saves (just save the item)
- Run multiple tools when one suffices
- Load full reference docs unless user asks how something works
Reference
Full tool documentation: Workflows/Reference.md
