octocode

octocode 概覽

這是什麼

Octocode 是一個以證據為優先的程式碼研究平台，專為 AI 代理與開發者設計。它使用同一套工具集（ripgrep + AST 搜尋、樹狀結構、精確讀取與 LSP）來研究本地程式碼與外部程式碼（GitHub 儲存庫、PR、npm）。可作為 CLI 或 MCP 伺服器使用，背後由 Rust 引擎驅動，能在單一檔案或大型儲存庫中提供快速且 token 高效的結果。

主要功能

• 代理驅動的高效流程：將低成本步驟串聯成最佳化的研究流程，具備智慧分頁與最小化功能，避免模型過度擷取。
• 可擴展至大型儲存庫：在一個儲存庫中發現模式後，可追蹤引入該模式的 PR，再跨其他儲存庫與本地檔案進行追蹤。
• 智慧 GitHub 流程：以相同的「廣搜尋、窄讀取」原則，平行批次查詢程式碼、PR、提交、議題與儲存庫。
• 無需 GitHub 即可運作：複製任何儲存庫，並將本地工具（搜尋、AST、LSP、內容）指向該儲存庫。
• 讀取結構而非雜訊：即時對 70 種以上語言進行最小化/骨架化。
• 快速且自足：搜尋、解析、導航與編輯都在單一預先建置的 Rust 引擎中執行。
• 預設安全：傳送給模型的每個位元組都會先掃描並編輯機密資訊。

使用情境

• 程式碼庫問題：搜尋本地或 GitHub 程式碼、讀取精確區域、瀏覽樹狀結構，並將檔案/行錨點帶入答案。
• 實作研究：在修改程式碼前，跨儲存庫、npm 套件、PR、提交與本地檔案比較模式。
• 語意導航：透過 LSP 解析定義、參考、呼叫者/被呼叫者、呼叫階層、懸浮提示、符號、診斷與型別關係。
• 結構比對：使用模式或 YAML 規則執行 AST 形狀搜尋，避免註解與字串造成誤判。
• 大型檔案上下文：對程式碼進行最小化、骨架化或分頁，讓代理將 token 花在相關結構而非樣板。
• 代理工作流程：透過 MCP、CLI 與 Agent Skills 使用相同的引擎。

快速開始

必要條件：Node.js 20.12+ 使用 npx 執行 Octocode CLI： npx octocode --help 選擇性驗證 GitHub（可解鎖私有儲存庫與更高的 API 速率限制）： npx octocode auth login npx octocode status 選擇介面： CLI： npx octocode MCP：將以下設定加入 MCP 用戶端設定檔（或使用儲存庫 README 中的一鍵安裝選項）。

授權與價格

授權為 MIT。此專案為開放原始碼。

內容整理自該專案公開的 README 與儲存庫資訊。