context-mode

Overview

Context Mode is an MCP server designed to solve the context window optimization problem for AI coding agents. It provides four key solutions: context saving by sandboxing tools to keep raw data out of the context window (98% reduction), session continuity through tracking all operations in SQLite and retrieving only relevant information when needed, 'think in code' approach that encourages LLMs to write scripts rather than processing large data directly, and flexible output style that doesn't enforce prose-style responses. The project supports 15 platforms and has been adopted by major tech companies like Microsoft, Google, Meta, and Amazon.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• ctx_batch_execute

  Executes multiple code snippets in a batch

  Try:Run these Python scripts togetherTry:Batch execute these code snippets
• ctx_execute

  Executes code in the specified language and returns results

  Try:Run this JavaScript codeTry:Execute this Python script
• ctx_execute_file

  Executes a code file and returns the results

  Try:Run this TypeScript fileTry:Execute the Python script at this path
• ctx_index

  Indexes content for later retrieval

  Try:Index this file for later searchTry:Add this content to the knowledge base
• ctx_search

  Searches indexed content using BM25

  Try:Find all files mentioning API keysTry:Search for functions that handle authentication
• ctx_fetch_and_index

  Fetches content from a source and indexes it

  Try:Fetch and index this webpageTry:Download and index this GitHub repository
• ctx_stats

  Shows context savings and usage statistics

  Try:Show me context usage statisticsTry:How much context has been saved
• ctx_doctor

  Runs diagnostic checks on the system

  Try:Check if everything is workingTry:Run diagnostics
• ctx_upgrade

  Upgrades context-mode to the latest version

  Try:Update context-modeTry:Upgrade to the latest version
• ctx_purge

  Deletes all indexed content from the knowledge base

  Try:Clear all indexed contentTry:Delete the knowledge base
• ctx_insight

  Opens personal analytics dashboard

  Try:Show my productivity analyticsTry:Open the analytics dashboard

Comparable tools

Installation

/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

npm install -g context-mode

{
  "mcpServers": {
    "context-mode": {
      "command": "context-mode"
    }
  },
  "hooks": {
    "BeforeTool": [{
      "matcher": "run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill",
      "hooks": [{ "type": "command", "command": "context-mode hook gemini-cli beforetool" }]
    }],
    "AfterTool": [{
      "matcher": "",
      "hooks": [{ "type": "command", "command": "context-mode hook gemini-cli aftertool" }]
    }],
    "PreCompress": [{
      "matcher": "",
      "hooks": [{ "type": "command", "command": "context-mode hook gemini-cli precompress" }]
    }],
    "SessionStart": [{
      "matcher": "",
      "hooks": [{ "type": "command", "command": "context-mode hook gemini-cli sessionstart" }]
    }]
  }
}

{
  "mcpServers": {
    "context-mode": {
      "command": "npx",
      "args": ["-y", "context-mode"]
    }
  }
}

FAQ

How does Context Mode reduce context usage?

Context Mode reduces context usage by 98% through sandboxing tool outputs. Instead of putting raw data into the context window, it stores the data in SQLite and only indexes it, allowing the model to retrieve relevant information when needed.

Is Context Mode compatible with my favorite AI coding platform?

Yes, Context Mode supports 15 platforms including Claude Code, Gemini CLI, VS Code Copilot, Cursor, and others. It provides specific installation instructions for each platform.

Compare context-mode with