Mathematically Proven

95.7% Token Savings
Verified & Reproducible

Current benchmark with 1,650 decisions proves Continuity is 23.3× more efficient than embedding decisions in CLAUDE.md. At this scale, CLAUDE.md needs 336,704 tokens — well beyond the context window limit and literally cannot run. See the math, run the tests yourself.

95.7%+
Token Savings
23.3×
More Efficient
O(1)
Complexity
968
Decision Breakpoint

Token Comparison

Current benchmark: CLAUDE.md climbs to 336,704 tokens while Continuity stays at 14,472

1,650
Benchmark decisions
336,704
CLAUDE.md tokens
14,472
Continuity tokens
95.7%
Token savings

The Scaling Problem

CLAUDE.md hits context limits. Continuity scales infinitely.

Token Growth: O(n) vs O(1)

CLAUDE.md grows linearly with decisions. Continuity stays constant.

0K50K100K150K200K250K300K350K025050075010001650Number of DecisionsTokens200K Context LimitCLAUDE.md BREAKS
CLAUDE.md (O(n) - Linear Growth)
Continuity (O(1) - Constant)
Context Window Limit (200K)

CLAUDE.md hits the 200K context limit at about 968 decisions and becomes unusable.

At 1,650 decisions CLAUDE.md would require 336,704 tokens - about 168.4% of the context window. Continuity stays at 14,472 tokens for the current benchmark.

Calculate Your Savings

See exactly how much you'll save based on your project size

Calculate Your Savings

100
10 requests500 requests
Monthly Savings
$96.67
vs current benchmark baseline
Annual Savings
$1160.04
First year total
Net Monthly
$+87.67
After $9 subscription
Return on Investment
+974%
✅ Profitable from day one
Token Savings
95.7%
Verified against the current benchmark snapshot
Benchmark cost without Continuity:$101.01/month
Benchmark cost with Continuity:$13.34/month
Your Total Savings:$96.67/month
Verified against current benchmark data (1,650 decisions)

CLAUDE.md vs Continuity

They serve different purposes and work best together

.md

CLAUDE.md

Static documentation file

Token CostO(n)

Grows linearly with decisions

Loads all decisions every time

Manual editing required

Breaks around 968 decisions

No search capability

Best for: Project instructions, coding standards, static context (~5,277 base tokens)

C

Continuity

Intelligent memory system

Token CostO(1)

Constant regardless of decisions

Loads only what you need

Automatic logging

Unlimited decisions

Semantic search

Best for: Decision memory, searchable history, dynamic queries (14,472 tokens at the current benchmark)

FeatureCLAUDE.mdContinuity
Static project instructions
Store 100 decisions
Store 500 decisions
Store 968+ decisions
Search specific decisions
Semantic similarity search
Log decisions automatically
Session handoff
Decision relationships
Link decisions to code
Token efficient(O(n) vs O(1))
Team collaboration

Real-World Scenario: "What did we decide about authentication?"

With CLAUDE.md Only
  1. 1.Claude loads all 1,650 decisions (336,704 tokens — 168.4% of the 200K context window)
  2. 2.Claude scans through everything manually
  3. 3.You've already used 168.4% of context before even asking
  4. 4.Doesn't work - exceeds the context limit
With Continuity
  1. 1.Claude calls search_decisions("authentication")
  2. 2.Returns only the relevant decisions (~14,472 tokens at the benchmark)
  3. 3.You've used just 7.8% of context
  4. 4.Works with room for long conversations

The Verdict: They Work TOGETHER

Use CLAUDE.md for:

What to do (instructions)

Use Continuity for:

What we decided (memory)

CLAUDE.md and Continuity serve different purposes. They're not replacements - they're complements.

Scaling Projections

Token savings increase as your project grows

DecisionsCLAUDE.md TokensContinuity TokensSavingsStatus
5015,32014,4725.5%
10025,36314,47242.9%
25055,49314,47273.9%
500105,70914,47286.3%
968LIMIT199,71414,47292.8%
1,000206,142*14,47293.0%
1,650ACTUAL336,704*14,47295.7%
5,0001,009,601*14,47298.6%
10,0002,013,925*14,47299.3%
*At about 968 decisions, CLAUDE.md hits the 200K context limit
Both approaches still work below the limit
Above the limit, only Continuity remains usable

Key Insight: Savings increase as your project grows.

The more decisions you log, the more efficient Continuity becomes. At 10,000 decisions, you save nearly 99.4% of tokens.

$26.05
Continuity monthly cost
(current benchmark)
$606.07
CLAUDE.md monthly cost
(current benchmark)
$580.02
Monthly savings
at the benchmark scale

Mathematical Proof

Formal proof that Continuity provides asymptotically superior token efficiency

SymbolDefinitionMeasured Value
nTotal number of decisions1,650
DTotal decision tokens331,427
dAverage tokens per decision200.9
bBase CLAUDE.md instructions5,277
qSearch queries per session3
rResults returned per query15
CContext window limit200,000

The Fundamental Equation

lim[n→∞]TContinuity / TCLAUDE.md = 0

As decisions grow, Continuity's relative cost approaches zero.

Q.E.D.

Getting Started

What is Continuity?

Continuity is a RAG-based synthetic memory system for AI coding assistants. It captures architectural decisions, tracks documentation changes, and provides persistent context across sessions - solving the problem of AI assistants "forgetting" previous conversations.

Key Advantage: O(1) Token Efficiency

Unlike CLAUDE.md which loads ALL decisions every session (O(n)), Continuity uses semantic search to retrieve only relevant decisions - keeping token usage constant regardless of project size.

Installation

Option 1: VS Code Marketplace (Recommended)

  1. Open the Continuity listing on the VS Code Marketplace
  2. Click Install
  3. Reload VS Code when prompted

Option 2: Manual Installation

  1. Download the latest .vsix file
  2. Open VS Code
  3. Press Cmd/Ctrl+Shift+P
  4. Type "Extensions: Install from VSIX..."
  5. Select the downloaded file
  6. Reload VS Code when prompted

What Happens on First Launch

After installation, everything is automatic:

  • Zero-click tool setup — auto-detects your AI tools (Claude Code, Cursor, GitHub Copilot, Google Gemini, and more) and configures synthetic memory access
  • Smart Node.js resolution — finds Node.js automatically for nvm, fnm, volta, and Homebrew users
  • Initial Project Scanner — scans your codebase and creates draft decisions for tech stack, dependencies, database, testing, deployment, API style, and project structure
  • Git seeding — pre-populates decisions from your recent commit history so the sidebar is never empty
  • A .continuity/ folder is created with your decisions as plain JSON — commit it to git and share with your team

14-Day Free Trial

Your trial starts immediately with all Pro features and unlimited decisions. After the trial, you keep read-only access to existing decisions and can continue logging up to the free-tier limit. No credit card required.

Features

14-Day Free Trial

Every new install starts with a full 14-day trial — unlimited decisions, all Pro features. After the trial, unlimited decision logging stays free; premium features require Pro.

All Pro Features for 14 Days

Unlimited decisions, semantic search, knowledge graph, Dream Engine

Profile-based Memory Tools

Current shipping profiles expose 9 core tools, 25 standard tools, or 36 full tools depending on the client

Zero-Click Setup

Auto-detects and configures all your AI tools

5 Detection Layers

19 detection points auto-capture decisions

Pro Features

Upgrade to Pro
Semantic Search

Hybrid keyword + embedding-based search (O(1) efficiency)

Knowledge Graph

1,500 node capacity — force-directed, radial, tree, and DAG layouts with inline editing

Dream Engine

4-phase memory consolidation — deduplicates, resolves contradictions, scores staleness

Decision Lifecycle

Active, draft, outdated, deprecated, superseded — old decisions auto-outdated, never deleted

Code Intelligence

Link decisions to code locations, check refactoring safety against linked decisions

Decision Enforcement

Pre-commit audit blocks if >5 unlogged, post-commit auto-logs stubs, decision debt tracker

Unlimited Decisions

No storage limits — in-memory cache with ~60% smaller trimmed memory responses

Export

CSV, JSON, Markdown formats

License Management

Activation

After purchasing, you'll receive a license key via email. Activate it in VS Code:

  1. Press Cmd/Ctrl+Shift+P
  2. Type "Continuity: Activate License"
  3. Enter your license key and email
View detailed activation guide →

License Types

Monthly Subscription$9/month

Renews monthly, cancel anytime. 14-day free trial included.

Annual Subscription$89/year

Renews annually, save 18% vs monthly. 14-day free trial included.

Lifetime License$199 one-time

Never expires, all future updates included

MCP Integration

What is MCP?

Continuity uses the Model Context Protocol (MCP) as a communication layer to provide AI assistants like Claude, Cursor, and Copilot with persistent memory and decision logging capabilities.

Available Memory Tools

Continuity ships profile-based synthetic memory tool sets for logging, searching, analyzing, and managing architectural decisions. Current profiles expose 9 core tools, 25 standard tools, or 36 full tools depending on the client and install mode.

@continuity log_decision

Log architectural decisions with question, answer, and optional tags

@continuity search_decisions

Search logged decisions by keyword or semantic query - O(1) efficiency

@continuity get_quick_context

Load project history, recent decisions, and session context at conversation start

@continuity session-handoff

Get complete project context including recent decisions and documentation status

continuity://ai-usage-guide

AI-specific usage guidelines and best practices

continuity://ai-instructions

Persistent AI instructions that survive across sessions

API Reference

License Validation

POST /api/licenses/validate
{
  "license_key": "12345678-90ab-cdef-1234-567890abcdef",
  "device_id": "device-uuid",
  "device_name": "MacBook Pro",
  "platform": "darwin",
  "vscode_version": "1.84.0",
  "extension_version": "2.13.89-beta"
}

Device Management

POST /api/devices/activate

Activate a new device for a license

DELETE /api/devices/:device_id

Deactivate a device

Troubleshooting

License activation fails

  • Verify your license key is correct (check for typos)
  • Ensure you're using the email from your purchase
  • Check your internet connection
  • Contact support if issue persists

MCP integration not working

  • Verify Continuity is installed and activated
  • Check that your AI assistant supports MCP
  • Restart your AI assistant application
  • Check MCP server logs in VS Code Output panel

Need more help? Email us at [email protected] with your license key and a description of the issue.

Frequently Asked Questions

Why is Continuity more efficient than CLAUDE.md?

CLAUDE.md loads ALL decisions into context every session (O(n) complexity - grows linearly). Continuity uses semantic search to retrieve only relevant decisions (O(1) complexity - constant). At 1,650 decisions, CLAUDE.md needs 336,704 tokens while Continuity uses just 14,472 tokens. That is a 95.7% token reduction with a 23.3× efficiency advantage, and CLAUDE.md is already beyond the 200K context window.

What happens when I have more than 968 decisions?

Around 968 decisions, CLAUDE.md reaches the 200K context window and stops fitting reliably. Continuity keeps working because it only retrieves the relevant decisions needed for the current session.

How much money will I save?

Based on the current benchmark at 600 sessions/month: CLAUDE.md costs $606.07/month while Continuity costs $26.05/month. That is $580.02/month or $6,960.21/year in benchmark-model savings.

Is my data secure?

Yes. All decisions are stored locally in your project's .continuity/ folder. License validation uses encrypted HTTPS connections, and we never store your decision data on our servers.

What AI assistants does Continuity work with?

Continuity works with any AI assistant through its synthetic memory system: Claude Code, Cursor, GitHub Copilot, Google Gemini, and more. Zero-click setup auto-detects your installed tools and configures memory connections automatically.

Still have questions?

Our team is here to help. Reach out via email or check our activation guide for step-by-step instructions.