Skip to content
Back to search

gortex

High-performance code-intelligence engine for AI agents and IDE, supports 257 languages, multi repositories, based on graph, with access via CLI, MCP Server, and API. AI coding agents teammate - expose only needed information, cutting token usage up to 50x. 100% local. Discord: https://discord.gg/39MFHu3J5d

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zzet/gortex with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zzet/gortex'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zzet--gortex/badge.svg)](/listings/zzet--gortex)

HTML

<a href="/listings/zzet--gortex"><img src="/api/listings/zzet--gortex/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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

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

Detects OS/arch, verifies SHA256 + cosign, installs to PATH. Re-run to upgrade. Homebrew, `.deb` / `.rpm` / `.apk`, scoop, signed binaries, and from-source builds: [docs/installation.md](docs/installation.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 195 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <p align="center">
  3. <img src="assets/wall.svg" alt="Gortex" width="500">
  4. </p>
  5. ### High-performance and efficient code-intelligence engine for AI agents and IDE
  6. #### Indexes code into graph and exposes it via CLI, MCP Server, and web UI. Multi-repository support by default.
  7. #### Single static binary for macOS, Linux, and Windows — no dependency chain, simple installation and use.
  8. ---
  9. [![CI](https://github.com/zzet/gortex/actions/workflows/ci.yml/badge.svg)](https://github.com/zzet/gortex/actions/workflows/ci.yml)
  10. [![Latest release](https://img.shields.io/github/v/release/zzet/gortex?logo=github&sort=semver)](https://github.com/zzet/gortex/releases/latest)
  11. [![Sigstore signed](https://img.shields.io/badge/sigstore-signed-66D4FF?logo=sigstore&logoColor=white)](docs/installation.md#verifying-releases-supply-chain-security)
  12. [![SLSA 3](https://img.shields.io/badge/SLSA-Level%203-green)](https://slsa.dev/spec/v1.0/levels#build-l3)
  13. [![VirusTotal](https://img.shields.io/badge/VirusTotal-0%2F91-brightgreen?logo=virustotal)](https://www.virustotal.com/gui/url/00e1094b39c9bd7db4d5a179b1d56173f85c915075057fd3cc64bfbb9b735b11/detection)
  14. [![macOS](https://img.shields.io/badge/macOS-supported-blue.svg)](#)
  15. [![Linux](https://img.shields.io/badge/Linux-supported-blue.svg)](#)
  16. [![Windows](https://img.shields.io/badge/Windows-supported-blue.svg)](#)
  17. [![MCP Toplist](https://mcptoplist.com/badge/glama%2Fzzet%2Fgortex.svg)](https://mcptoplist.com/server/glama%2Fzzet%2Fgortex)
  18. [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/zzet/gortex/badge)](https://scorecard.dev/viewer/?uri=github.com/zzet/gortex)
  19. [![Go Reference](https://pkg.go.dev/badge/github.com/zzet/gortex.svg)](https://pkg.go.dev/github.com/zzet/gortex)
  20. [![Discord](https://img.shields.io/badge/Discord-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/39MFHu3J5d)
  21. <br />
  22. <a href="https://trendshift.io/repositories/36832" target="_blank"><img src="https://trendshift.io/api/badge/repositories/36832" alt="zzet%2Fgortex | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  23. </div>
  24. > [!IMPORTANT]
  25. > **Gortex has no cryptocurrency token or coin.** We have not issued, authorized, or endorsed any cryptocurrency token, coin, token sale, or airdrop. Any claims of an official Gortex token or an affiliation with such projects are false. Verify announcements through the [official Gortex repository](https://github.com/zzet/gortex).
  26. High-quality parsing 257 languages/grammars through tree-sitter AST analysis, in-process resolvers, enhanced with [compiler-grade resolution](https://github.com/zzet/gortex/blob/main/docs/lsp.md) for Python, TypeScript / JavaScript, PHP, C#, Go, C, C++, Java, Kotlin, Swift, Zig, Rust, Ruby, Elixir, Ocaml, Haskell, and [others](https://github.com/zzet/gortex/blob/main/docs/languages.md#at-a-glance) - producing a persistent provenance-tiered knowledge graph of functions, classes, call chains, HTTP routes, and cross-service contracts and calls with a strong confidence model. 175 (configurable) MCP tools - use only what you need. Zero dependencies. Plug and play across 19 coding agents. **Up to 50× fewer tokens per response**. Reproducible [benchmarks](BENCHMARK.md).
  27. > 19 AI coding agents (Claude Code, Kiro, Cursor, Windsurf, VS Code / Copilot, Continue.dev, Cline, OpenCode, Antigravity, Codex CLI, Gemini CLI, Zed, Aider, Kilo Code, OpenClaw, Hermes, Oh My Pi, Pi, Kimi) supported out of the box.
  28. >
  29. > One install configures every one detected on your machine — see [docs/agents.md](docs/agents.md).
  30. <details>
  31. <summary>Gortex Web UI — force-directed knowledge graph visualization</summary>
  32. ![Gortex Web UI — force-directed knowledge graph visualization](assets/graph.png)
  33. </details>
  34. ## Why it matters
  35. - **50× fewer tokens per response** — graph-native lookups beat naive file reads. Agents read **just what they need**, not the full file, not the 500-line file around it.
  36. - **Full development cycle** - no 'read file before edit'. Agents ask for sources, tell what to change, and don't waste context of reading noise.
  37. - **257 languages/grammars** - every file in the repository reachable; no mix of tools and bloating/hallycinating agents. Three tiers (bespoke tree-sitter, regex, forest-backed signatures) plus Jupyter and Databricks notebooks → [docs/languages.md](docs/languages.md)
  38. - **Cross-repo by default** — N repos in one graph; contracts, references, and call chains span repo boundaries with evidence-gated resolution, contract matching, impact analysis, per-session isolation → [docs/multi-repo.md](docs/multi-repo.md)
  39. - **Extreamly fast analysis** — a precomputed depth-3 reach index turns blast-radius queries into O(seeds × reach) map lookups. Safe to ask "what breaks if I change this?" on every edit. No dozens of tool calls to grasp context.
  40. - **Zero external dependencies** — single binary, everything in-process. No network, no model download to get started. Install, start daemon, use.
  41. - **Agent integrations (20)** — `gortex init` configures every detected coding assistant on the machine → [docs/agents.md](docs/agents.md)
  42. - **100+ MCP tools, 16 resources, 3 prompts** — symbol lookup, call chains, blast radius, dataflow, clone detection, refactoring, code actions → [docs/mcp.md](docs/mcp.md)
  43. - **Semantic search default-on** — baked GloVe-50d (3.8 MB embedded), store-native FTS5/BM25 + vector with adaptive alpha fusion, zero deps; opt-in MiniLM / Ollama / OpenAI → [docs/semantic-search.md](docs/semantic-search.md)
  44. - **Speculative execution** — `preview_edit` / `simulate_chain` answer "what would change if I applied this WorkspaceEdit?" without touching disk
  45. - **Live editor overlays** — push unsaved buffers as a shadow graph; tools read through it. Branching for parallel speculative sessions
  46. - **GCX1 wire format** — published, round-trippable. **An additional −27% tokens vs JSON** at same fidelity → [docs/wire-format.md](docs/wire-format.md)
  47. - **Long-living daemon** — one process serves every IDE window; live fsnotify, an on-disk SQLite graph store, incremental restart, OS-supervised lifecycle
  48. - **10 LLM providers (optional)** — local llama.cpp, Anthropic, OpenAI, Ollama, Claude / Codex CLI subprocess, Gemini, Bedrock, DeepSeek, Requesty → [docs/llm.md](docs/llm.md)
  49. - **Composable safety** — `verify_change`, `check_guards`, `audit_agent_config` flag broken callers, guard violations, stale docs before they ship
  50. - **PR review, end to end** — `gortex prs` triages open PRs (per-PR blast radius, merge-order conflicts via shared communities, AI-ranked queue, reviewer suggestions); `gortex review` emits line-anchored findings with a BLOCK/REVIEW/APPROVE verdict from a graph-grounded rulepack; MCP tools (`pr_risk`, `get_pr_impact`, `review`, `review_pack`, `post_review`, …) expose it to agents → [docs/cli.md](docs/cli.md)
  51. - **HTTP server + Web UI** — versioned `/v1/*` API + MCP 2026 Streamable HTTP; standalone Next.js 15 UI with five 3D graph modes → [docs/server.md](docs/server.md)
  52. - **Telemetry off by default** — opt-in anonymous tool/command counts only (no code, paths, names, or exact counts); nothing transmitted unless you configure an endpoint. `gortex telemetry on|off|status`; honours `DO_NOT_TRACK` → [docs/telemetry.md](docs/telemetry.md)
  53. Full catalog of features: [docs/features.md](docs/features.md). Complete CLI reference: [docs/cli.md](docs/cli.md).
  54. ## Install
  55. ```bash
  56. # macOS / Linux
  57. curl -fsSL https://get.gortex.dev | sh
  58. # Windows (PowerShell)
  59. irm https://get.gortex.dev/install.ps1 | iex
  60. ```
  61. Detects OS/arch, verifies SHA256 + cosign, installs to PATH. Re-run to upgrade. Homebrew, `.deb` / `.rpm` / `.apk`, scoop, signed binaries, and from-source builds: [docs/installation.md](docs/installation.md).
  62. ## Quick Start
  63. ```bash
  64. gortex install # one-time machine setup (MCP, skills, slash commands)
  65. gortex daemon start --detach # background daemon
  66. gortex track ~/projects/myapp # add a repo
  67. cd ~/projects/myapp && gortex init # per-repo: .mcp.json, hooks, community routing
  68. ```
  69. Your AI assistant now uses graph queries. Full 15-minute walkthrough: [docs/onboarding.md](docs/onboarding.md).
  70. ## Cross-Repo API Contracts
  71. Gortex auto-detects API contracts across repos and matches providers to consumers, surfaced via the `contracts` MCP tool and the web UI Contracts page.
  72. | Contract type | Detection | Provider | Consumer |
  73. |--------------|-----------|----------|----------|
  74. | **HTTP routes** | Framework annotations (gin, Express, FastAPI, Spring, …) | Route handler | HTTP client calls (`fetch`, `http.Get`) |
  75. | **gRPC** | Proto service definitions | Service RPC | Client stub calls |
  76. | **GraphQL** | Schema type/field definitions | Schema | Query/mutation strings |
  77. | **Message topics** | Kafka / RabbitMQ / NATS / Redis pub/sub | Publish calls | Subscribe calls |
  78. | **WebSocket** | Event emit/listen patterns | `emit()` | `on()` |
  79. | **Env vars** | `os.Getenv`, `process.env`, `.env` files | `Setenv` / `.env` | `Getenv` / `process.env` |
  80. | **OpenAPI** | Swagger / OpenAPI spec files | Spec paths | (linked to HTTP routes) |
  81. | **Temporal workflows** | Go / Java SDK annotations | Activity / workflow function | `ExecuteActivity` / `ExecuteChildWorkflow` |
  82. Contracts are normalised to canonical IDs (e.g. `http::GET::/api/users/{id}`) and matched across repos to detect orphan providers / consumers and mismatches. See [docs/contracts.md](docs/contracts.md).
  83. ## Scale — battle-tested on large repos
  84. Measured on an Apple Silicon laptop with the default CGO build.
  85. | Repository | Files | Nodes | Edges | Index time | Throughput | Peak heap |
  86. | ---------- | ----: | ----: | ----: | ---------: | ---------: | --------: |
  87. | [torvalds/linux](https://github.com/torvalds/linux) | 70,333 | 1,690,174 | 6,239,570 | ~3 min | 300 files/s | 5.07 GB |
  88. | [microsoft/vscode](https://github.com/microsoft/vscode) | 10,762 | 204,501 | 808,902 | ~1 min | 143 files/s | 580 MB |
  89. | zzet/gortex (self) | 430 | 5,583 | 53,830 | 3.4s | 127 files/s | 52 MB |
  90. Parsing dominates wall time (65–80 %); reference resolution and search-index build scale sub-linearly.
  91. ## Token savings dashboard
  92. `gortex savings` reports tokens saved vs naive file reads — per-call, per-session, and cumulative across restarts, priced in USD against the headline model.
  93. ```text
  94. Gortex Token Savings
  95. ====================
  96. Cost avoided: $168.69 (claude-opus-4) across 1,878 calls · 11,246,094 tokens saved
  97. Today ████████░░░░░░░░ 50.0% saved 9,200 / 18,400 tokens $0.14
  98. Last 7 days ██████████░░░░░░ 62.5% saved 60,100 / 96,200 tokens $0.90
  99. All time ███████████████░ 93.3% saved 11,246,094 / 12,050,716 tokens $168.69
  100. ```
  101. `--verbose` adds the per-tool breakdown; `--json` is machine-readable. Full reference: [docs/savings.md](docs/savings.md).
  102. ## Architecture
  103. ```
  104. gortex binary
  105. CLI (cobra) ──> MultiIndexer ──> Graph store (SQLite, shared, per-repo indexed)
  106. MCP (stdio) ──────────────────> Query Engine (repo/project/ref scoping)
  107. HTTP /v1/* ──────────────────> same tools + /v1/graph + /v1/events (SSE)
  108. Daemon (unix) ──────────────────> shared graph for every MCP client, session isolation
  109. MultiWatcher <── filesystem events (fsnotify, per-repo)
  110. CrossRepoResolver ──> cross-repo edge creation (type-aware)
  111. Persistence ──> the same SQLite store, written as it indexes
  112. ```
  113. Data flow, graph schema (node and edge kinds, multi-repo fields, test taxonomy), persistence model: [docs/architecture.md](docs/architecture.md).
  114. ## Documentation
  115. | Topic | Reference |
  116. | --- | --- |
  117. | First-time walkthrough | [onboarding.md](docs/onboarding.md) |
  118. | Installation & supply-chain verification | [installation.md](docs/installation.md) |
  119. | Full feature catalog | [features.md](docs/features.md) |
  120. | CLI reference | [cli.md](docs/cli.md) |
  121. | MCP tools, resources, prompts | [mcp.md](docs/mcp.md) |
  122. | Multi-repo workspaces | [multi-repo.md](docs/multi-repo.md) |
  123. | HTTP server + Web UI + MCP 2026 transport | [server.md](docs/server.md) |
  124. | Cross-repo API contracts | [contracts.md](docs/contracts.md) |
  125. | Semantic search | [semantic-search.md](docs/semantic-search.md) |
  126. | Optional LLM features | [llm.md](docs/llm.md) |
  127. | LSP integration | [lsp.md](docs/lsp.md) |
  128. | Per-community skills & agent usage | [skills.md](docs/skills.md) |
  129. | AI agent adapters (20) | [agents.md](docs/agents.md) |
  130. | Supported languages (257) | [languages.md](docs/languages.md) |
  131. | Token savings | [savings.md](docs/savings.md) |
  132. | GCX1 wire format | [wire-format.md](docs/wire-format.md) |
  133. | Architecture & graph schema | [architecture.md](docs/architecture.md) |
  134. | Evaluation methodology | [04-evaluation/](docs/04-evaluation/) |
  135. | Telemetry & privacy | [telemetry.md](docs/telemetry.md) |
  136. | Versioning policy | [versioning.md](docs/versioning.md) |
  137. ## Building from source
  138. ```bash
  139. make build # binary with version stamping
  140. make test # go test -race; PKGS=./internal/<pkg>/... narrows it
  141. make lint # golangci-lint
  142. ```
  143. Requires Go 1.26+ and CGO (for tree-sitter C bindings).
  144. ## License
  145. Apache License 2.0. See [LICENSE.md](LICENSE.md). Copyright 2024-2026 Andrey Kumanyaev <me@zzet.org>.
  146. ## Contributing
  147. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding features, language extractors, and submitting PRs.
  148. New contributors are very welcome — join us on [Discord](https://discord.gg/39MFHu3J5d) and introduce yourself. It's the easiest place to ask questions, check whether someone is already working on something, and get feedback on a design before you write the code.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.