bgauryy/octocode

解決的問題

Octocode 是一個以證據為先的程式碼研究平台，旨在為 AI 代理和開發者提供來自本機檔案系統和外部來源（如 GitHub 和 npm）的精確且 Token 高效的上下文。它允許代理串接搜尋、結構分析和語意導航，以找到任務所需的確切程式碼區域，從而防止代理進行「猜測」。

運作方式

Octocode 使用高效能的 Rust 引擎來驅動一套 17 個工具。它可以部署為 AI 助理的 Model Context Protocol (MCP) 伺服器，或作為獨立的 CLI。該系統整合了 ripgrep、AST（抽象語法樹）搜尋和 Language Server Protocol (LSP) 來執行深度程式碼分析。它支援「廣泛搜尋，精確讀取」的工作流程，讓代理可以找到一個模式，僅擷取符合的特定行，並使用壓縮/骨架化來減少 Token 使用量，同時保留 70 多種語言的結構含義。

適用對象

• AI 代理開發者：正在建構需要研究和修改程式碼庫，但不過度擷取 Token 的代理的開發者。
• 軟體工程師：希望擁有一個強大且統一的 CLI 來研究本機和遠端儲存庫的開發者。 -- AI 助理使用者：使用相容 MCP 的用戶端（如 Cursor、VS Code、Windsurf）並希望其 AI 能對其程式碼進行深度、基於證據存取的使用者。

亮點

• 統一研究流程：適用於本機程式碼、GitHub 儲存庫、PR、issue 和 npm 套件的單一工具集。
• Token 效率：內建壓縮和骨架化功能，可去除樣板程式碼並減輕模型上下文視窗的壓力。
• 語意導航：完整的 LSP 支援，用於解析定義、參考、呼叫者和型別關係。
• 結構搜尋：基於 AST 的搜尋，可避免來自註解或字串的誤判。
• 高效能：由 Rust 引擎驅動，可跨單一檔案或大型 monorepos 快速執行。
• MCP 整合：原生支援 Model Context Protocol，可在現代 AI IDE 中一鍵安裝。