Gortex — Công Cụ Phân Tích Mã Nguồn Cho AI Agent • blog.dopana

AI coding agent rất mạnh mẽ, nhưng chúng lãng phí token khi đọc toàn bộ file chỉ để lấy một chữ ký hàm, một call chain, hoặc một đồ thị import. Với các codebase lớn, sự kém hiệu quả này tích tụ rất nhanh.

Gortex giải quyết vấn đề này bằng cách index code thành một knowledge graph bền vững và cung cấp nó qua CLI, MCP Server, HTTP API và Web UI — cho AI agent quyền truy cập chính xác vào thông tin chúng cần.

Gortex là gì?#

Gortex là một engine phân tích mã nguồn hiệu suất cao, dựa trên đồ thị, được xây dựng bằng Go. Nó index codebase của bạn thành một knowledge graph có cấu trúc bằng phân tích AST tree-sitter trên 257 ngôn ngữ, được tăng cường với phân giải cấp compiler cho các ngôn ngữ chính. Kết quả là một binary tĩnh duy nhất (không phụ thuộc gì) hoạt động như bộ não cho AI coding assistant của bạn.

Nó hỗ trợ 19 AI coding agent ngay khi cài đặt — Claude Code, Kiro, Cursor, Windsurf, VS Code / Copilot, Continue.dev, Cline, OpenCode, Antigravity, Codex CLI, Gemini CLI, Zed, Aider, và nhiều hơn nữa. Một lần gortex init cấu hình mọi agent được phát hiện trên máy bạn.

Tại sao Gortex quan trọng#

Giảm Token Tới 50 Lần#

Thay vì đưa cho AI agent toàn bộ file nguồn, Gortex phục vụ các truy vấn đồ thị con chính xác. Bảng điều khiển tiết kiệm token cho thấy kết quả thực:

Cost avoided: $168.69 (claude-opus-4) across 1,878 calls · 11,246,094 tokens saved
Today        ████████░░░░░░░░ 50.0% saved   9,200 / 18,400 tokens
Last 7 days  ██████████░░░░░░ 62.5% saved  60,100 / 96,200 tokens
All time     ███████████████░ 93.3% saved  11,246,094 / 12,050,716 tokens $168.69

txt

257 Ngôn Ngữ#

Ba tầng phân tích đảm bảo mọi file trong repository đều có thể truy cập:

Bespoke tree-sitter grammars — Phân tích AST sâu cho các ngôn ngữ chính
Regex-based extractors — Phủ rộng cho các hệ sinh thái nhỏ hơn
Forest-backed signatures — Dự phòng cho các ngôn ngữ không được xử lý rõ ràng

Thêm hỗ trợ cho Jupyter và Databricks notebooks.

Đa Repository Mặc Định#

N repos trong một đồ thị — contracts, tham chiếu và call chain vượt qua ranh giới repository với phân giải dựa trên bằng chứng, đối sánh contract và phân tích tác động.

Không Phụ Thuộc Gì#

Binary tĩnh duy nhất cho macOS, Linux và Windows. Không cần Node.js, Python hay Docker. Không cần mạng. Cài đặt và sử dụng ngay lập tức.

Tính năng chính#

Tính năng	Mô tả
257 ngữ pháp ngôn ngữ	Tree-sitter AST + phân giải cấp compiler cho Python, TypeScript, Go, Rust, C/C++, Java, Kotlin, Swift, Zig, Ruby và hơn thế
175 công cụ MCP	Tra cứu symbol, call chain, blast radius, dataflow, phát hiện clone, code actions — chỉ dùng những gì bạn cần
19 tích hợp agent	Một lệnh cấu hình mọi AI coding agent trên máy bạn
Cross-repo API contracts	Tự động phát hiện HTTP, gRPC, GraphQL, Kafka, WebSocket contracts xuyên repos
Tìm kiếm ngữ nghĩa	GloVe-50d tích hợp sẵn (3.8 MB, zero deps), tùy chọn MiniLM / Ollama / OpenAI
Phân tích blast radius	Precomputed depth-3 reach index biến truy vấn tác động thành O(seeds × reach) lookups
Thực thi thăm dò	`preview_edit` / `simulate_chain` trả lời “điều gì sẽ thay đổi?” mà không chạm vào đĩa
Editor overlays trực tiếp	Đẩy bộ đệm chưa lưu thành đồ thị ảo; phân nhánh cho các phiên thăm dò song song
Định dạng GCX1	−27% token so với JSON cùng độ trung thực
PR review	End-to-end: phân loại PR mở, phát hiện với verdict BLOCK/REVIEW/APPROVE
Web UI	Next.js 15 độc lập với trực quan hóa đồ thị 3D force-directed
Daemon chạy dài	Một tiến trình phục vụ mọi cửa sổ IDE; fsnotify trực tiếp, snapshot đĩa, khởi động lại

Cross-Repo API Contracts#

Gortex tự động phát hiện API contracts xuyên repository và ghép nối providers với consumers:

Loại contract	Phát hiện
HTTP routes	Framework annotations (gin, Express, FastAPI, Spring…)
gRPC	Proto service definitions
GraphQL	Schema type/field definitions
Message topics	Kafka / RabbitMQ / NATS / Redis pub/sub
WebSocket	Event emit/listen patterns
Env vars	`os.Getenv`, `process.env`, `.env` files
OpenAPI	Swagger / OpenAPI spec files
Temporal workflows	Go / Java SDK annotations

Các contract được chuẩn hóa thành canonical IDs (vd: http::GET::/api/users/{id}) và đối sánh xuyên repos để phát hiện orphan providers/consumers và sự không khớp.

Hiệu năng#

Đo trên máy tính Apple Silicon:

Repository	Files	Nodes	Edges	Thời gian index	Peak heap
torvalds/linux	70,333	1,690,174	6,239,570	~3 phút	5.07 GB
microsoft/vscode	10,762	204,501	808,902	~1 phút	580 MB
Gortex (self)	430	5,583	53,830	3.4s	52 MB

Phân tích chiếm 65–80% thời gian; phân giải tham chiếu và xây dựng search-index scale sub-linearly.

Cài đặt#

# macOS / Linux
curl -fsSL https://get.gortex.dev | sh

# Windows (PowerShell)
irm https://get.gortex.dev/install.ps1 | iex

bash

Trình cài đặt tự động phát hiện OS/arch, xác minh chữ ký SHA256 + cosign và cài đặt vào PATH.

Bắt đầu nhanh#

gortex install # Thiết lập máy một lần
gortex daemon start --detach # Khởi động daemon nền
gortex track ~/projects/myapp # Thêm repository
cd ~/projects/myapp && gortex init # Cấu hình mỗi repo

bash

AI assistant của bạn bây giờ sử dụng graph queries thay vì đọc file thô.

Kiến trúc#

gortex binary
CLI (cobra) ──> MultiIndexer ──> In-Memory Graph (shared, per-repo indexed)
MCP (stdio) ──────────────────> Query Engine
HTTP /v1/* ────────────────────> Same tools + /v1/graph + /v1/events (SSE)
Daemon ────────────────────────> Shared graph for every MCP client
MultiWatcher <── filesystem events (fsnotify, per-repo)
CrossRepoResolver ──> Cross-repo edge creation
Persistence ──> gob+gzip snapshot

txt

Gortex vs. Giải pháp thay thế#

Tính năng	Gortex	Graphify	RAG truyền thống
Ngôn ngữ	257	36	N/A
Đa repo	✅ Hạng nhất	❌ Một repo	❌
Công cụ MCP	175	Hạn chế	❌
Tích hợp agent	19	CLI skill	❌
Tiết kiệm token	Tới 50×	Đáng kể	❌
Contracts xuyên repo	✅ HTTP, gRPC, Kafka…	❌	❌
Zero dependencies	✅ Binary Go đơn	✅ Python	❌ Embeddings
Blast radius	✅ O(seeds × reach)	❌	❌
Web UI	✅ Đồ thị 3D	✅ Đồ thị tương tác	❌
Giấy phép	Apache 2.0	Apache 2.0	Khác nhau

Tổng kết#

Gortex là một engine phân tích mã nguồn hoàn chỉnh đáng kinh ngạc. Với hỗ trợ 257 ngôn ngữ, đa repo mặc định, 175 công cụ MCP, 19 tích hợp agent, và tiết kiệm token đã được chứng minh tới 50 lần, nó là một trong những công cụ toàn diện nhất để làm cho AI coding agent thực sự hiệu quả trên các codebase lớn.

Thiết kế binary đơn không phụ thuộc giúp bạn có thể cài đặt và bắt đầu tiết kiệm token trong vài phút — không cần hạ tầng, không phụ thuộc, không cần đám mây.

Gortex — Công Cụ Phân Tích Mã Nguồn Cho AI Agent