Context Mode

context-mode

Intercepts tool results (Read, Grep, WebFetch, Bash) and stores them in SQLite with FTS5 full-text search. Instead of dumping full output into context, returns only BM25-ranked relevant snippets.

License & Attribution

context-mode is by Murat Kemal Soylu, licensed under Elastic License 2.0 (ELv2). CC Commander installs it as an external npm package — we do not bundle, modify, or redistribute its source code. See the context-mode repo for full license terms.

When to Use

• File-heavy exploration (reading many files)
• Large grep/search results
• Web fetches returning large pages
• Any task where tool output exceeds what's needed

Tools Available

• ctx_execute — run command, result stored in sandbox
• ctx_batch_execute — run multiple commands, all indexed
• ctx_search — BM25 search over sandboxed results
• ctx_fetch_and_index — fetch URL and index content
• ctx_execute_file — execute a file, index output
• ctx_index — manually index content

Installation

npm install -g context-mode

Then add to ~/.claude.json:

{
  "mcpServers": {
    "context-mode": {
      "type": "stdio",
      "command": "context-mode"
    }
  }
}

Verify

The MCP tools should appear in your Claude Code session. Run ctx_execute with a simple command to verify sandboxing works.

Relationship to Other Tools

• RTK: Filters CLI output BEFORE context (input side)
• context-mode: Filters tool results AFTER execution (output side)
• Headroom: Optimizes at API proxy layer (request/response)
• ClaudeSwap: Account rotation for rate limits
• These are complementary layers, not competing.

Token Optimization Stack