mksglu/context-mode

Context window optimization for AI coding agents. Sandboxes tool output (98% reduction), persists session memory, and enforces routing across 17 platforms via MCP + hooks.

這是什麼

Context Mode 是一個面向 AI coding agent 的 MCP server / 外掛工具組，主張處理「context problem 的另一半」：不是讓模型讀更多，而是避免把大量工具輸出塞進上下文。README 舉例，Playwright snapshot、GitHub issues、access log 這類原始資料很快吃掉 context；Context Mode 透過 sandbox tools 把原始資料留在工具側，只把必要結果交給模型，宣稱可把 315 KB 壓到 5.4 KB，減少 98%。另一個核心是 session continuity：檔案編輯、git 操作、任務、錯誤與使用者決策會記到 SQLite，並以 FTS5 / BM25 在需要時檢索相關事件，而不是在壓縮對話時整包倒回上下文。

為什麼上榜

這個專案切中近期 agent 工程的痛點：大家開始把 Claude Code、Codex、Copilot、Gemini CLI 等工具當成長時間協作者，真正卡住的往往不是模型能力，而是工具輸出、讀檔與 verbose 對話把 context 快速耗盡。Context Mode 的亮點在於它不是單純加一層「摘要」，而是把工作流改成 Think in Code：讓 LLM 寫腳本分析資料，只輸出結果，例如 README 對比「47 次 Read 讀 700 KB」與一次 ctx_execute 輸出 3.6 KB。再加上支援多個 agent 平台、今日新增 246 stars、總星數達 27,269，很容易引發正在重度使用 AI coding 工具的開發者共鳴。

適合誰，可以拿來做什麼

它最適合已經把 AI agent 放進日常開發流程的人：例如常用 Claude Code 外掛、Copilot CLI、Gemini CLI，或會讓 agent 大量讀 log、掃 repo、跑測試、查 issue 的團隊。若你的問題是「agent 做到一半忘記前面改了什麼」、「工具輸出太長導致對話被壓縮」、「為了統計幾個檔案卻把整包原始碼讀進 context」，Context Mode 提供的是 路由與資料治理層。它也適合想觀察 context savings 的團隊，README 提到 ctx_stats、status line 與 hosted Insight dashboard。不過它不是一般終端工具的替代品，也不承諾提升模型本身能力；價值在於讓 agent 少浪費上下文、延長可持續工作的時間。

上手

README 對 Claude Code 的安裝最完整。前提是 Claude Code v1.0.33+，若 /plugin 不可用需先更新；安裝後重啟 Claude Code 或執行 /reload-plugins，再用 doctor 檢查 hooks、FTS5 與 plugin registration。

/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode
/context-mode:ctx-doctor

若只想用 MCP，不需要 hooks 與 slash commands，也可先試 MCP-only：

claude mcp add context-mode -- npx -y context-mode

其他平台如 Gemini CLI、VS Code Copilot、JetBrains Copilot、GitHub Copilot CLI 多半採用 npm install -g context-mode 後再設定 MCP 與 hooks；多數平台需要 Node.js >= 22.5 或 Bun。

README 重點摘要

• Context Mode 的核心賣點是 sandbox tools：把大段原始工具輸出留在上下文外，只回傳模型真正需要的結果。
• Session continuity 以 SQLite + FTS5 + BM25 保存並檢索工作事件；若不使用 --continue，README 表示前一段 session 資料會立即刪除，避免新 session 混入舊狀態。
• README 強調 Think in Code：讓 agent 寫腳本計算、搜尋與彙整，取代多次讀檔或大量貼資料到 context。
• Claude Code 版本提供 plugin marketplace 安裝、hooks 自動路由、11 個 MCP tools，以及 ctx_stats、ctx_doctor、ctx_index、ctx_search 等指令。
• 它刻意不做「回答風格」強制；README 認為 routing 應專注在資料去哪裡，而不是規定模型最終輸出要多短。