{"id":48752116,"url":"https://github.com/zzet/gortex","last_synced_at":"2026-06-17T00:02:14.026Z","repository":{"id":349559649,"uuid":"1202875287","full_name":"zzet/gortex","owner":"zzet","description":"High-performance code graph and code intelligence engine, supports 257 languages, multi repositories,  with access via CLI, MCP Server, and API.  Built for AI coding agents - expose only needed information, cutting token usage up to 50x. 100% local.","archived":false,"fork":false,"pushed_at":"2026-06-14T21:39:20.000Z","size":24142,"stargazers_count":126,"open_issues_count":10,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-14T23:11:20.038Z","etag":null,"topics":["ai-tools","antigravity","claude-code","code-analysis","code-assistant","context-window","context-window-optimization","context-window-optimizer","copilot","cursor","developer-tools","graphrag","kiro","knowledge-graph","local-first","mcp-server","prompts","skills","tokens","windsurf"],"latest_commit_sha":null,"homepage":"https://gortex.dev/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zzet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"docs/agents.md","dco":null,"cla":null}},"created_at":"2026-04-06T13:47:15.000Z","updated_at":"2026-06-14T21:39:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"aa43e7ec-8b37-494d-8113-5c5a9eb78918","html_url":"https://github.com/zzet/gortex","commit_stats":null,"previous_names":["zzet/gortex"],"tags_count":76,"template":false,"template_full_name":null,"purl":"pkg:github/zzet/gortex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzet%2Fgortex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzet%2Fgortex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzet%2Fgortex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzet%2Fgortex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zzet","download_url":"https://codeload.github.com/zzet/gortex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzet%2Fgortex/sbom","scorecard":{"id":1246107,"data":{"date":"2026-04-15T23:37:19Z","repo":{"name":"github.com/zzet/gortex","commit":"986067a2d807a45db702685b4a9bb08de6d309f1"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":4.6,"checks":[{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Security-Policy","score":4,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Warn: no linked content found","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Code-Review","score":0,"reason":"Found 0/18 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/release.yml:128","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:32","Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecard.yml:33","Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release.yml:9","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:20","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:80: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:82: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:145: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:159: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:96: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:131: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/scorecard.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/scorecard.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:62: update your workflow using https://app.stepsecurity.io/secureworkflow/zzet/gortex/scorecard.yml/main?enable=pin","Info:   0 out of  13 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 12 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE.md:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Signed-Releases","score":6,"reason":"3 out of the last 5 releases have a total of 6 signed artifacts.","details":["Info: signed release artifact: checksums.txt.sig: https://github.com/zzet/gortex/releases/tag/v0.6.1","Info: signed release artifact: checksums.txt.sig: https://github.com/zzet/gortex/releases/tag/v0.6.0","Info: signed release artifact: checksums.txt.sig: https://github.com/zzet/gortex/releases/tag/v0.5.4","Warn: release artifact v0.5.3 not signed: https://api.github.com/repos/zzet/gortex/releases/309498502","Warn: release artifact v0.5.2 not signed: https://api.github.com/repos/zzet/gortex/releases/309472495","Info: provenance for release artifact: multiple.intoto.jsonl: https://github.com/zzet/gortex/releases/tag/v0.6.1","Info: provenance for release artifact: multiple.intoto.jsonl: https://github.com/zzet/gortex/releases/tag/v0.6.0","Info: provenance for release artifact: multiple.intoto.jsonl: https://github.com/zzet/gortex/releases/tag/v0.5.4","Warn: release artifact v0.5.3 does not have provenance: https://api.github.com/repos/zzet/gortex/releases/309498502","Warn: release artifact v0.5.2 does not have provenance: https://api.github.com/repos/zzet/gortex/releases/309472495"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Contributors","score":10,"reason":"project has 6 contributing companies or organizations","details":["Info: found contributions from: @viodotcom, FindHotel, QyuTeam, Undev, kaize, lenshq"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"6 out of 6 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2026-04-16T01:28:29.416Z","repository_id":349559649,"created_at":"2026-04-16T01:28:29.417Z","updated_at":"2026-04-16T01:28:29.417Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34428197,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","antigravity","claude-code","code-analysis","code-assistant","context-window","context-window-optimization","context-window-optimizer","copilot","cursor","developer-tools","graphrag","kiro","knowledge-graph","local-first","mcp-server","prompts","skills","tokens","windsurf"],"created_at":"2026-04-12T20:02:49.866Z","updated_at":"2026-06-17T00:02:14.014Z","avatar_url":"https://github.com/zzet.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/wall.svg\" alt=\"Gortex\" width=\"500\"\u003e\n\u003c/p\u003e\n\n### Code graph and intelligence engine that indexes repositories\n#### and exposes it via CLI, MCP Server, and web UI.\n\n---\n\n[![CI](https://github.com/zzet/gortex/actions/workflows/ci.yml/badge.svg)](https://github.com/zzet/gortex/actions/workflows/ci.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/zzet/gortex)](https://goreportcard.com/report/github.com/zzet/gortex)\n[![Latest release](https://img.shields.io/github/v/release/zzet/gortex?logo=github\u0026sort=semver)](https://github.com/zzet/gortex/releases/latest)\n[![Go Reference](https://pkg.go.dev/badge/github.com/zzet/gortex.svg)](https://pkg.go.dev/github.com/zzet/gortex)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/zzet/gortex/badge)](https://scorecard.dev/viewer/?uri=github.com/zzet/gortex)\n\n[![Sigstore signed](https://img.shields.io/badge/sigstore-signed-66D4FF?logo=sigstore\u0026logoColor=white)](docs/installation.md#verifying-releases-supply-chain-security)\n[![SLSA 3](https://img.shields.io/badge/SLSA-Level%203-green)](https://slsa.dev/spec/v1.0/levels#build-l3)\n[![VirusTotal](https://img.shields.io/badge/VirusTotal-0%2F91-brightgreen?logo=virustotal)](https://www.virustotal.com/gui/url/00e1094b39c9bd7db4d5a179b1d56173f85c915075057fd3cc64bfbb9b735b11/detection)\n\n[![macOS](https://img.shields.io/badge/macOS-supported-blue.svg)](#)\n[![Linux](https://img.shields.io/badge/Linux-supported-blue.svg)](#)\n[![Windows](https://img.shields.io/badge/Windows-supported-blue.svg)](#)\n\n[![Claude Code](https://img.shields.io/badge/Claude_Code-supported-blueviolet.svg)](docs/agents.md)\n[![Kiro](https://img.shields.io/badge/Kiro-supported-blueviolet.svg)](docs/agents.md)\n[![Cursor](https://img.shields.io/badge/Cursor-supported-blueviolet.svg)](docs/agents.md)\n[![Windsurf](https://img.shields.io/badge/Windsurf-supported-blueviolet.svg)](docs/agents.md)\n[![VS Code / Copilot](https://img.shields.io/badge/VS_Code-supported-blueviolet.svg)](docs/agents.md)\n[![Continue.dev](https://img.shields.io/badge/Continue.dev-supported-blueviolet.svg)](docs/agents.md)\n[![Cline](https://img.shields.io/badge/Cline-supported-blueviolet.svg)](docs/agents.md)\n[![opencode](https://img.shields.io/badge/opencode-supported-blueviolet.svg)](docs/agents.md)\n[![Antigravity](https://img.shields.io/badge/Antigravity-supported-blueviolet.svg)](docs/agents.md)\n[![Codex CLI](https://img.shields.io/badge/Codex_CLI-supported-blueviolet.svg)](docs/agents.md)\n[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-supported-blueviolet.svg)](docs/agents.md)\n[![Zed](https://img.shields.io/badge/Zed-supported-blueviolet.svg)](docs/agents.md)\n[![Aider](https://img.shields.io/badge/Aider-supported-blueviolet.svg)](docs/agents.md)\n[![Kilo Code](https://img.shields.io/badge/Kilo_Code-supported-blueviolet.svg)](docs/agents.md)\n[![OpenClaw](https://img.shields.io/badge/OpenClaw-supported-blueviolet.svg)](docs/agents.md)\n[![Hermes](https://img.shields.io/badge/Hermes-supported-blueviolet.svg)](docs/agents.md)\n\n**Up to 50× fewer tokens per response.** See [BENCHMARK.md](BENCHMARK.md) or reproduce it yourself.\n\n\u003c/div\u003e\n\n\u003e Built for 16 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). One install configures every one detected on your machine — see [docs/agents.md](docs/agents.md).\n\n\u003cdetails\u003e\n\u003csummary\u003eGortex Web UI — force-directed knowledge graph visualization\u003c/summary\u003e\n\n![Gortex Web UI — force-directed knowledge graph visualization](assets/graph.png)\n\n\u003c/details\u003e\n\n## Why it matters\n\n- **50× fewer tokens per response** — graph-native lookups beat naive file reads. Agents read the symbol they need, not the 500-line file around it.\n- **Sub-millisecond impact 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.\n- **Cross-repo by default** — N repos in one graph; contracts, references, and call chains span repo boundaries with evidence-gated resolution.\n- **Zero external dependencies** — single binary, everything in-process. No network, no model download to get started.\n\n## Install\n\n```bash\n# macOS / Linux\ncurl -fsSL https://get.gortex.dev | sh\n\n# Windows (PowerShell)\nirm https://get.gortex.dev/install.ps1 | iex\n```\n\nDetects 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).\n\n## Quick Start\n\n```bash\ngortex install                          # one-time machine setup (MCP, skills, slash commands)\ngortex daemon start --detach            # background daemon\ngortex track ~/projects/myapp           # add a repo\ncd ~/projects/myapp \u0026\u0026 gortex init      # per-repo: .mcp.json, hooks, community routing\n```\n\nYour AI assistant now uses graph queries. Full 15-minute walkthrough: [docs/onboarding.md](docs/onboarding.md).\n\n## Highlights\n\n- **257 languages** — three tiers (bespoke tree-sitter, regex, forest-backed signatures) plus Jupyter and Databricks notebooks → [docs/languages.md](docs/languages.md)\n- **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)\n- **Semantic search default-on** — baked GloVe-50d (3.8 MB embedded), hybrid BM25 + vector + RRF, zero deps; opt-in MiniLM / Ollama / OpenAI → [docs/semantic-search.md](docs/semantic-search.md)\n- **Multi-repo workspaces** — cross-repo symbol resolution, contract matching, impact analysis, per-session isolation → [docs/multi-repo.md](docs/multi-repo.md)\n- **Speculative execution** — `preview_edit` / `simulate_chain` answer \"what would change if I applied this WorkspaceEdit?\" without touching disk\n- **Live editor overlays** — push unsaved buffers as a shadow graph; tools read through it. Branching for parallel speculative sessions\n- **GCX1 wire format** — published, round-trippable. **−27 % tokens vs JSON** at same fidelity → [docs/wire-format.md](docs/wire-format.md)\n- **Long-living daemon** — one process serves every IDE window; live fsnotify, on-disk snapshots, sub-second restart, OS-supervised lifecycle\n- **9 LLM providers (optional)** — local llama.cpp, Anthropic, OpenAI, Ollama, Claude / Codex CLI subprocess, Gemini, Bedrock, DeepSeek → [docs/llm.md](docs/llm.md)\n- **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)\n- **Composable safety** — `verify_change`, `check_guards`, `audit_agent_config` flag broken callers, guard violations, stale docs before they ship\n- **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)\n- **Agent integrations (16)** — `gortex init` configures every detected coding assistant on the machine → [docs/agents.md](docs/agents.md)\n\nFull catalog of features: [docs/features.md](docs/features.md). Complete CLI reference: [docs/cli.md](docs/cli.md).\n\n## Cross-Repo API Contracts\n\nGortex auto-detects API contracts across repos and matches providers to consumers, surfaced via the `contracts` MCP tool and the web UI Contracts page.\n\n| Contract type | Detection | Provider | Consumer |\n|--------------|-----------|----------|----------|\n| **HTTP routes** | Framework annotations (gin, Express, FastAPI, Spring, …) | Route handler | HTTP client calls (`fetch`, `http.Get`) |\n| **gRPC** | Proto service definitions | Service RPC | Client stub calls |\n| **GraphQL** | Schema type/field definitions | Schema | Query/mutation strings |\n| **Message topics** | Kafka / RabbitMQ / NATS / Redis pub/sub | Publish calls | Subscribe calls |\n| **WebSocket** | Event emit/listen patterns | `emit()` | `on()` |\n| **Env vars** | `os.Getenv`, `process.env`, `.env` files | `Setenv` / `.env` | `Getenv` / `process.env` |\n| **OpenAPI** | Swagger / OpenAPI spec files | Spec paths | (linked to HTTP routes) |\n| **Temporal workflows** | Go / Java SDK annotations | Activity / workflow function | `ExecuteActivity` / `ExecuteChildWorkflow` |\n\nContracts 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).\n\n## Scale — battle-tested on large repos\n\nMeasured on an Apple Silicon laptop with the default CGO build.\n\n| Repository | Files | Nodes | Edges | Index time | Throughput | Peak heap |\n| ---------- | ----: | ----: | ----: | ---------: | ---------: | --------: |\n| [torvalds/linux](https://github.com/torvalds/linux) | 70,333 | 1,690,174 | 6,239,570 | ~3 min | 300 files/s | 5.07 GB |\n| [microsoft/vscode](https://github.com/microsoft/vscode) | 10,762 | 204,501 | 808,902 | ~1 min | 143 files/s | 580 MB |\n| zzet/gortex (self) | 430 | 5,583 | 53,830 | 3.4s | 127 files/s | 52 MB |\n\nParsing dominates wall time (65–80 %); reference resolution and search-index build scale sub-linearly.\n\n## Token savings dashboard\n\n`gortex savings` reports tokens saved vs naive file reads — per-call, per-session, and cumulative across restarts, priced in USD against the headline model.\n\n```text\nGortex Token Savings\n====================\nCost avoided:   $168.69 (claude-opus-4) across 1,878 calls · 11,246,094 tokens saved\n\nToday       ████████░░░░░░░░   50.0%  saved 9,200 / 18,400 tokens   $0.14\nLast 7 days ██████████░░░░░░   62.5%  saved 60,100 / 96,200 tokens  $0.90\nAll time    ███████████████░   93.3%  saved 11,246,094 / 12,050,716 tokens  $168.69\n```\n\n`--verbose` adds the per-tool breakdown; `--json` is machine-readable. Full reference: [docs/savings.md](docs/savings.md).\n\n## Architecture\n\n```\ngortex binary\n  CLI (cobra)    ──\u003e MultiIndexer ──\u003e In-Memory Graph (shared, per-repo indexed)\n  MCP (stdio)    ──────────────────\u003e Query Engine (repo/project/ref scoping)\n  HTTP /v1/*     ──────────────────\u003e same tools + /v1/graph + /v1/events (SSE)\n  Daemon (unix)  ──────────────────\u003e shared graph for every MCP client, session isolation\n                  MultiWatcher    \u003c── filesystem events (fsnotify, per-repo)\n                  CrossRepoResolver ──\u003e cross-repo edge creation (type-aware)\n                  Persistence     ──\u003e gob+gzip snapshot (pluggable backend)\n```\n\nData flow, graph schema (node and edge kinds, multi-repo fields, test taxonomy), persistence model: [docs/architecture.md](docs/architecture.md).\n\n## Documentation\n\n| Topic | Reference |\n| --- | --- |\n| First-time walkthrough | [onboarding.md](docs/onboarding.md) |\n| Installation \u0026 supply-chain verification | [installation.md](docs/installation.md) |\n| Full feature catalog | [features.md](docs/features.md) |\n| CLI reference | [cli.md](docs/cli.md) |\n| MCP tools, resources, prompts | [mcp.md](docs/mcp.md) |\n| Multi-repo workspaces | [multi-repo.md](docs/multi-repo.md) |\n| HTTP server + Web UI + MCP 2026 transport | [server.md](docs/server.md) |\n| Cross-repo API contracts | [contracts.md](docs/contracts.md) |\n| Semantic search | [semantic-search.md](docs/semantic-search.md) |\n| Optional LLM features | [llm.md](docs/llm.md) |\n| LSP integration | [lsp.md](docs/lsp.md) |\n| Per-community skills \u0026 agent usage | [skills.md](docs/skills.md) |\n| AI agent adapters (15) | [agents.md](docs/agents.md) |\n| Supported languages (257) | [languages.md](docs/languages.md) |\n| Token savings | [savings.md](docs/savings.md) |\n| GCX1 wire format | [wire-format.md](docs/wire-format.md) |\n| Architecture \u0026 graph schema | [architecture.md](docs/architecture.md) |\n| Evaluation methodology | [04-evaluation/](docs/04-evaluation/) |\n| Versioning policy | [versioning.md](docs/versioning.md) |\n\n## Building from source\n\n```bash\nmake build          # binary with version stamping\nmake test           # go test -race ./...\nmake lint           # golangci-lint\n```\n\nRequires Go 1.26+ and CGO (for tree-sitter C bindings).\n\n## License\n\nApache License 2.0. See [LICENSE.md](LICENSE.md). Copyright 2024-2026 Andrey Kumanyaev \u003cme@zzet.org\u003e.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding features, language extractors, and submitting PRs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzet%2Fgortex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzzet%2Fgortex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzet%2Fgortex/lists"}