v0.1.0 · 開源 · MIT 2026-05-04

15 stars MIT MCP-native

別讓你的 AI 再 grep 整個世界。

Coograph 讓你的 AI 編程工具更聰明、更省錢：直接指向程式碼庫裡真正相關的檔案，而不是浪費 token 把所有東西都讀一遍。

Coograph 把你的程式碼庫解析成 SQLite 依賴圖。編程代理在讀取任何檔案前先查詢它。在固定任務上測量。SQLite。MCP 原生。支援多工具。

$ 立即開始在 GitHub 查看

面向獨立開發者、indie hacker，以及評估 AI 工具的工程負責人。

適合：獨立開發者 · indie hacker · 評估 AI 工具的資深工程師

工具： Claude Code · Cursor · VS Code Copilot · Windsurf · Codex CLI · OpenCode · Aider · Cline

問題

「grep 一切」稅。

讓編程代理「給 OrderService.place_order() 加快取」，看它怎麼做。它 grep 這個類別名稱。回傳 20 個檔案。為了保險，全都讀一遍。其中大部分是測試、文件、下游呼叫端、SDK 型別 —— 跟快取該放哪裡沒有任何關係。

這個稅以 token、工具呼叫、延遲的形式支付，每個任務都付一次 —— 直接拉高你的 AI 基礎設施帳單。

 $ grep -rl "OrderService" src/
docs/architecture.md
docs/deployment.md
migrations/001_initial.sql
README.md
src/api/routes.py
src/api/schemas.py
src/audit/audit_log.py
src/billing/billing_service.py
src/billing/invoice.py
src/client/order_client.ts
src/notifications/email.py
src/orders/order_dto.py
src/orders/order_events.py
src/orders/order_service.py
src/orders/order_validator.py
src/types/index.ts
tests/conftest.py
tests/test_api.py
tests/test_billing_service.py
tests/test_order_service.py

20 個比對。代理為了保險全都讀了一遍。

方案

圖優先上下文。

你的代理在讀取任何檔案前先呼叫 get_minimal_context(task)。圖回傳這次變更真正相關的 4 個檔案。其他一概不回傳。

試試查詢點一個任務。看看圖回傳什麼。

即時示範

無圖 $ grep -rl "OrderService" src/

docs/architecture.md

docs/deployment.md

migrations/001_initial.sql

README.md

src/api/routes.py

src/api/schemas.py

src/audit/audit_log.py

src/billing/billing_service.py

src/billing/invoice.py

src/client/order_client.ts

src/notifications/email.py

src/orders/order_dto.py

src/orders/order_events.py

src/orders/order_repository.py

src/orders/order_service.py

src/orders/order_validator.py

src/types/index.ts

tests/conftest.py

tests/test_api.py

tests/test_billing_service.py

有圖 → 回傳的最小上下文

src/orders/order_service.py 1,578b

定義 place_order —— 變更落點
src/orders/order_repository.py 1,493b

place_order 的讀取路徑 —— 快取包在這裡
src/cache/cache.py 562b

快取抽象 —— 新增依賴
src/cache/policy.py 406b

快取策略 —— 按命名空間定義 TTL

原理

三步。沒有魔法。

建構圖。
克隆儲存庫。在任何支援的工具裡執行 /coograph-init（Claude Code、Cursor、Copilot、Windsurf、Codex CLI、OpenCode、Aider、Cline）。tree-sitter 遍歷每個原始檔。
```
$ /coograph-init
→ parsing 47 files…
→ wrote .code-graph/graph.db (1.2 MB)
```

先查詢，再讀取。

代理在讀取任何檔案前先呼叫 get_minimal_context(task)。它拿回真正相關的 4 個檔案，而不是單純比對關鍵字的 20 個。

> get_minimal_context("Add caching to OrderService.place_order()")
→ src/orders/order_service.py
→ src/orders/order_repository.py
→ src/cache/cache.py
→ src/cache/policy.py

提交時自動更新。

git 鉤子只重新解析 SHA-1 變化的檔案。更新只需毫秒級。

$ git commit -m "fix: cache TTL"
[main 4f3a8c1] fix: cache TTL
→ graph updated in 12ms (2 files re-parsed)

v0.2 即將推出 → 獨立 coograph CLI

實證

基準測試。

固定任務：「Add caching to OrderService.place_order()」。固定夾具：bench/fixtures/sample-app/。兩者都已提交。結果可重現。

執行於 2026-05-04 · 測試平台 0.1.0 · 夾具 f34ca2e

79.7% 更少 token。 4.2× 更少工具呼叫。

常見重構任務上最高 約 80% 的 token 減少 —— 在儲存庫內的固定基準任務和可重現測試平台上測得。

無圖 —— 20 個檔案 / 19,056 位元組

docs/architecture.md 1,409

docs/deployment.md 1,210

migrations/001_initial.sql 1,081

README.md 1,093

src/api/routes.py 1,417

src/api/schemas.py 484

src/audit/audit_log.py 679

src/billing/billing_service.py 1,051

src/billing/invoice.py 546

src/client/order_client.ts 1,245

src/notifications/email.py 720

src/orders/order_dto.py 707

src/orders/order_events.py 631

src/orders/order_service.py 1,276

src/orders/order_validator.py 734

src/types/index.ts 549

tests/conftest.py 355

tests/test_api.py 1,095

tests/test_billing_service.py 1,121

tests/test_order_service.py 1,653

合計：19,056 b · ~4,764 token

有圖 —— 4 個檔案 / 3,876 位元組

src/cache/cache.py 593

src/cache/policy.py 429

src/orders/order_repository.py 1,578

src/orders/order_service.py 1,276

合計：3,876 b · ~969 token

方法論

bench/run.py 遍歷 bench/fixtures/sample-app/，把 grep -l "OrderService" 回傳的檔案集和 .bench-manifest.json 裡斷言的 4 個檔案的最小上下文比對，並回報位元組數和近似 token 數（位元組 ÷ 4）。測試平台 0.1.0，夾具 sha f34ca2e7ef40…。圓點 (●) 標記同時出現在兩欄的檔案。詳見 bench/README.md。

用例

它在哪裡勝出。

重構核心服務

給某個類別加快取、限流、埋點。圖回傳讀取路徑 + 依賴檔案；測試、文件、下游呼叫端都被排除。

> get_minimal_context("Add caching to OrderService.place_order()")
→ src/orders/order_service.py
→ src/orders/order_repository.py
→ src/cache/cache.py
→ src/cache/policy.py

接入橫切關注點

給路由加限流、加驗證守衛、給請求加埋點。圖回傳進入點 + 直接處理鏈；SDK 型別和無關路由都被排除。

> get_minimal_context("Add rate limiting to POST /orders")
→ src/api/routes.py
→ src/api/schemas.py
→ src/orders/order_service.py

擴充領域物件

給請求 DTO 加欄位。圖從 dataclass 追到 validator 再到 wire-format schema；測試和文件不進入。

> get_minimal_context("Add discount field to OrderRequest")
→ src/orders/order_service.py
→ src/orders/order_dto.py
→ src/orders/order_validator.py
→ src/api/schemas.py

對比

它有何不同。

Coograph 是唯一一款 MIT 授權、MCP 原生、支援多工具的程式碼圖，把所有資料存進可攜的 SQLite 資料庫。

不同工具，不同目標。下面是 Coograph 在我們在意的維度上的對比。

特性	Coograph	Sourcegraph	Cursor index	Aider repo-map
開源 (MIT)	✓	~ OSS Lite	—	✓
MCP 原生	✓	—	—	—
可攜 SQLite 圖	✓	— 私有索引	— 封閉索引	~ 僅記憶體
多工具支援	✓ Claude/Cursor/Copilot/Windsurf	~	— 僅 Cursor	~

開源 (MIT)

Coograph ✓
Sourcegraph ~

OSS Lite
Cursor index —
Aider repo-map ✓

MCP 原生

Coograph ✓
Sourcegraph —
Cursor index —
Aider repo-map —

可攜 SQLite 圖

Coograph ✓
Sourcegraph —

私有索引
Cursor index —

封閉索引
Aider repo-map ~

僅記憶體

多工具支援

Coograph ✓

Claude/Cursor/Copilot/Windsurf
Sourcegraph ~
Cursor index —

僅 Cursor
Aider repo-map ~

基於公開文件的特性對比。Sourcegraph：sourcegraph.com。Cursor：cursor.sh。Aider：aider.chat。如有錯漏，歡迎到 issue 區指出。

定價

開源永久免費。Pro 是服務。

Coograph 採用 MIT 授權、永久免費。儲存庫裡的一切都是開源的。

Coograph Pro 面向想要客製化協助的團隊：客製工作流程、為內部語言客製的解析器、與你 AI 編程工具的深度整合。提供服務，不是付費功能。

零風險首次通話。 如果我們沒辦法幫你削減 30% 以上的 AI 帳單，會在通話裡直說。

Audit · $1,500 · 一週

/pro/audit/

$20k 合作還太重？

產品化的一週交付 AI 編碼帳單快照。程式碼庫基準測試報告、三條具體改進建議、關於是否值得做 Pro 合作的直白判斷。固定價格、固定範圍，零推銷壓力。

查看 Coograph 稽核

Coograph Pro 服務

落地衝刺

約 $20k 起

2–4 週

把 Coograph 接入你的 AI 編程技術棧，端到端交付一兩個高價值工作流程。

技術棧設計：Claude Code、Cursor、Copilot、Windsurf、內部代理
對主程式碼庫的解析 + 圖建構
get_minimal_context() 把接入真實任務
知識傳遞，讓工程師沒有我們也能持續迭代

客製解析器與整合

依範圍

內部語言

面向有內部語言、重度框架客製或舊系統的團隊。

為你的程式碼客製的 tree-sitter 解析器和轉接器
涵蓋非標準或舊版元件的圖能力
整合到你自己的代理和內部開發工具

持續支援與基準測試

月度

月度服務

持續讓 Coograph 健康運行，並證明長期影響。

升級和圖效能的優先支援
在你自己的儲存庫上定期跑基準（token、呼叫次數、延遲）
下一步在哪裡用 Coograph 的建議

首次合作通常從 ~$20k 起，2–4 週首期。

對比 ~200 小時的內部工程 —— 按 $150/小時算就是 $30k 的開發時間，還沒上線一個工作流程就花掉了。

預約 30 分鐘的初步通話完整合作詳情

或寄信至 hello@coograph.com

FAQ

常見問題。

用白話說，Coograph 到底做什麼？

Coograph 為你的程式碼庫建一張 SQLite 依賴圖 —— 誰呼叫誰、誰匯入誰、誰測試誰。你的 AI 編程工具問 Coograph「這個任務我需要哪些檔案？」，拿到 3–5 個檔案的清單，而不是 grep 一個關鍵字回來 20+ 個檔案。讀的檔案少 = 花的 token 少 = AI 帳單更低，變更更快更安全。

為什麼 grep 不夠？

grep 找出所有提到某個字串的檔案。搜「OrderService」會拿到這個類別本身、每個呼叫端、每個測試、每個文件、每個 SDK 型別 —— 多數跟你要做的變更無關。AI 工具用 grep 然後為了保險全都讀，結果每個任務都為整個程式碼庫買單。圖只回傳相關依賴鄰域的檔案。

在 AI 編程帳單上到底能省多少？

在已提交的基準任務上，Coograph 比直接 grep + 讀取的流程省約 80% token、4 倍工具呼叫。實際節省取決於儲存庫規模和任務型態，但規律不變：儲存庫越大、變更越聚焦，節省越多。等 Phase 4 計算機上線後可以估算你自己的。

Coograph 給誰用？

為 Claude Max、Cursor Pro 或按 token 付費的 API 買單、眼看著 AI 帳單往上爬的獨立開發者和 indie hacker。在為團隊評估 AI 工具、擔心人均成本的工程負責人。任何覺得 AI 工具動手前讀太多、太慢的人。

Coograph 是開源嗎？Pro 到底多少錢？

是 —— MIT 授權、永久免費。儲存庫裡的一切都是開源的；沒有付費功能。Coograph Pro 是服務：客製整合、內部語言的客製解析器、持續的基準測試。首次合作通常從 $20k 起，2–4 週首期。如果我們在通話裡發現幫不了你顯著降低 AI 帳單，會直接說。

安裝到底要多久？

5 分鐘，如果你已經在用支援的 AI 工具之一（Claude Code、Cursor、Copilot、Windsurf、Codex CLI、OpenCode、Aider、Cline）。把 Coograph 克隆為相鄰目錄，在你的工具裡執行 /coograph-init，讓它把圖建好，搞定。每次提交時 git 鉤子自動重新解析變化的檔案。