The browser UI for Gortex — a code intelligence engine that indexes repositories into an in-memory knowledge graph. This Next.js app talks to a gortex server over HTTP+SSE and renders the graph, processes, contracts, guards, and investigations.
Looking for the CLI / MCP server / graph engine? That lives in zzet/gortex. This repo is the UI only.
# 1. Start a gortex server in the repo you want to explore
gortex serve # defaults to http://localhost:4747
# 2. In this repo, run the web UI
npm install
cp .env.local.example .env.local # edit if your server isn't on :4747
npm run dev
# Open http://localhost:3000Configuration is via .env.local (see .env.local.example):
| Variable | Default | Purpose |
|---|---|---|
NEXT_PUBLIC_GORTEX_URL |
http://localhost:4747 |
Base URL of the gortex server |
NEXT_PUBLIC_GORTEX_TOKEN |
(unset) | Bearer token — only when the server runs --auth-token |
npm run dev # dev server on :3000 (HMR)
npm run build # production build
npm run start # serve the production build
npm run typecheck # tsc --noEmit
npm run lint # next lintOr via make:
make install # npm install
make dev # npm run dev
make check # typecheck + lint + build (same as CI)
make clean # drop .next and tsbuildinfosrc/ Next.js App Router pages, components, and lib/hooks
public/ Static assets
.env.local.example Server URL + optional bearer token
AGENTS.md Source-of-truth doc for how pages consume data
Read AGENTS.md before making changes — it documents the
lib/hooks.ts → /v1/* contract the UI depends on.
See CONTRIBUTING.md and the Code of Conduct. Security issues: see SECURITY.md.
Pin remote uses: references in workflows, composite actions, and owned
workflow templates to full lowercase 40-character commit SHAs. Preserve the
original ref in an inline comment; resolve that ref upstream without upgrading
versions. Local ./ references stay local; docker:// references require a
sha256 digest.
Run the same validation as CI:
python3 -m pip install --require-hashes --only-binary=:all: -r scripts/action-pins-requirements.txt
python3 scripts/check_action_pins.pyAdministrators must make Validate pinned GitHub Actions / validate a required check in branch protection or rulesets. This PR does not change those settings. Immutable references prevent tag movement; they do not establish that upstream code or its transitive dependencies are trustworthy.
See LICENSE.md. Source-available under a PolyForm-based license; commercial license available for organizations above the thresholds described in the license.