Never Lose Context Again

Intelligent context management for AI conversations. Seamlessly continue your development sessions across token limits with automatic progress tracking.

Get Started View on GitHub
Coming
Soon
v0.1.3
Latest
Free
Apache 2.0 License

Built for Developers

🎯

Smart Token Monitoring

Real-time tracking of conversation token usage with intelligent break suggestions before hitting limits.

📝

Automatic Documentation

Generates markdown session files with conversation summaries, decisions, and progress tracking.

🔄

Seamless Restoration

Creates context restoration prompts for new sessions, maintaining perfect continuity across conversations.

🛠️

MCP Compatible

Works with Claude Desktop, Cursor, and any MCP-compatible client. Universal compatibility.

📁

File-Based Storage

Human-readable markdown files that work with git, making your AI conversations version controllable.

⚡

Zero Dependencies

Lightweight installation with minimal dependencies. Works locally without cloud requirements.

Quick Start

1

Install via npm

Install the MCP server globally using npm:

$ npm install -g context-continue-mcp

Or use with npx for one-time usage:

$ npx context-continue-mcp --project ./my-project
2

Configure Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "context-continue": {
      "command": "context-mcp",
      "args": ["--project", "/path/to/your/project"]
    }
  }
}
Note: Replace /path/to/your/project with your actual project directory.
3

Start Using Context Tools

Restart Claude Desktop and start using context management tools:

• context_start_session - Begin tracking
• context_track_message - Track important messages  
• context_get_status - Check token usage
• context_restore_session - Generate restoration prompt

The server will create a .context directory in your project with all tracking files.

4

Example Usage

Here's how it works in practice:

// Start a new session
context_start_session

// Work on your project...
// Token monitoring happens automatically

// When approaching limits:
context_get_status
→ "80% token usage - consider ending session"

// End session and get restoration prompt
context_restore_session
→ Generates full context for next session

🚀 Pro Tip

Use context_track_progress to manually log important decisions and milestones. This creates better restoration prompts for complex projects.

File Structure Created

The server automatically organizes your context in a clean, git-friendly structure:

your-project/
├── .context/
│   ├── config.json
│   ├── project_summary.md
│   ├── sessions/
│   │   ├── session_001_2025-05-31.md
│   │   ├── session_002_2025-06-01.md
│   │   └── current_session.md
│   ├── progress/
│   │   ├── milestones.md
│   │   ├── decisions.md
│   │   └── tasks.md
│   └── artifacts/
│       ├── diagrams/
│       ├── code_snippets/
│       └── documents/
└── your-source-code/