Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Nomos - Deterministic Git & AST Governance for AI Coding Agents

by mgantlettversion 4.23.0+1i★ 6iRuns in the cloudOfficial site ↗
Registry nameio.github.mgantlett/nomos

How to install

What it does

Search AI coding agent governance docs, 42 AST quality gates, Git worktree rules, and benchmarks.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Developer tools

Use together with

Skills that teach the AI this kind of work; they work alongside this one

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

by morluto★ 467,2351 skills

Skill · How-to guide

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

by multica-ai★ 234,1251 skills

Skill · How-to guideNo license stated

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

by Graphify-Labs★ 149,8731 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity10/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score30/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Nomos - Deterministic Git & AST Governance for AI Coding Agents. Follow https://mcp.popnx.com/i/mgantlett-nomos.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (sophialabs.ca) · ✓ Commands checked Nov 18, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameNomos - Deterministic Git & AST Governance for AI Coding Agents
    Remote MCP server URL · Addresshttps://sophialabs.ca/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsNomos - Deterministic Git & AST Governance for AI Coding Agents

  4. Try it

    Use Nomos - Deterministic Git & AST Governance for AI Coding Agents and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Nomos - Deterministic Git & AST Governance for AI Coding Agents or shows a Nomos - Deterministic Git & AST Governance for AI Coding Agents tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameNomos - Deterministic Git & AST Governance for AI Coding Agents
    Connection · Addresshttps://sophialabs.ca/mcp
  3. Pick Nomos - Deterministic Git & AST Governance for AI Coding Agents in a chat

    Start a new chat and pick Nomos - Deterministic Git & AST Governance for AI Coding Agents from your plugins before typing

  4. Try it

    Use Nomos - Deterministic Git & AST Governance for AI Coding Agents and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Nomos - Deterministic Git & AST Governance for AI Coding Agents or shows a Nomos - Deterministic Git & AST Governance for AI Coding Agents tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user nomos https://sophialabs.ca/mcp
  3. Type /mcp in Claude Code

    You should see Nomos - Deterministic Git & AST Governance for AI Coding Agents listed as connected

  4. Try it

    Use Nomos - Deterministic Git & AST Governance for AI Coding Agents and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Nomos - Deterministic Git & AST Governance for AI Coding Agents or shows a Nomos - Deterministic Git & AST Governance for AI Coding Agents tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Nomos - Deterministic Git & AST Governance for AI Coding Agents and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Nomos - Deterministic Git & AST Governance for AI Coding Agents or shows a Nomos - Deterministic Git & AST Governance for AI Coding Agents tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Nomos - Deterministic Git & AST Governance for AI Coding Agents and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Nomos - Deterministic Git & AST Governance for AI Coding Agents or shows a Nomos - Deterministic Git & AST Governance for AI Coding Agents tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://sophialabs.ca/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Nomos - Deterministic Git & AST Governance for AI Coding Agents💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user nomos https://sophialabs.ca/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "nomos": {
      "url": "https://sophialabs.ca/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "nomos": {
      "type": "http",
      "url": "https://sophialabs.ca/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
Apache-2.0
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
4.23.0+1
Published to registryi
Nov 18, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 19, 2026
Maker
mgantlett
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.

  • search_nomos_corpus

    Search Nomos Handbook chapters, Empirical Dispatches, Open-Core Architecture Specs, CLI reference, and comparison tables.

  • inspect_dod_gates

    Inspect the 42 compiled Go/AST Definition of Done gates, ERR_* failure diagnostics, and container/symlink/CapBAC IFC sandbox rules.

  • recommend_adoption_plan

    Generate a zero-risk Nomos onboarding plan (nomos xray, Branch Guard, CI SARIF, worktrees, or air-gapped GPU) tailored to repository scale.

  • compare_governance_approaches

    Compare Nomos against Prompt Wrappers, Style Linters, and Static AGENTS.md / .cursorrules with empirical benchmark receipts.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account mgantlett, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • ✓ Pass

    Endpoint responds

    Responded in 97 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 4 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mgantlett-nomos.svg)](https://mcp.popnx.com/en/servers/mgantlett-nomos)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Developer toolsi

  • More stars than 87% of the other 6116 servers in this category
  • Published to the registry more recently than 96% of the other 6116 servers in this category
  • Basic checks equal to or better than 99% of the other 6116 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Nomos - Deterministic Git & AST Governance for AI Coding Agents safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (4.23.0+1) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

by ahmedkhaleel2004Widely used★ 19KUpdated 2 months ago

Runs in the cloud✓ service owner · gitdiagram.comTried by the PopNx team

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

by AppllamaWidely used★ 5.2KUpdated 3 months ago

Runs in the cloud✓ service owner · appllama.io

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

by repowise-devWidely used↓ 6.5K/wk★ 8.2K Stars for the whole repoUpdated 6 days ago

Computer or cloud✓ service owner · repowise.dev
Compared with similar ones
This one
Nomos - Deterministic Git & AST Governance for AI Coding Agents
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoYesNoNo
Basic checks5/54/44/44/44/45/5
LicenseApache-2.0MITMITApache-2.0Apache-2.0AGPL-3.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Nomos (Νόμος)

Agents guess; Git cannot. The deterministic execution substrate between any coding agent and Git.


Coding agents optimize for making their prompt finish, even when that means deleting failing tests, returning empty // TODO stubs, editing linter configs, or stuffing new complexity into fragile legacy files.

Nomos is a single ~20 MB static Go binary (Apache 2.0, zero cloud account, zero telemetry) that sits between your coding agent (Claude Code, Cursor, OpenCode, Gemini CLI, Antigravity, Windsurf, or Aider) and Git. Just as PostgreSQL placed ACID transactions between applications and raw disk, Nomos places human-authored repository laws underneath machine speed so nothing touches main without passing compiled AST verification on feature branches.

Audit in 5 seconds. Guard every branch in one command. Scale when you need it:

curl -fsSL https://sophialabs.ca/install | bash

cd your-project && nomos xray . # 1. Read-only AI Hangover Score & hotspot scan (use --markdown to share) nomos init # 2. Enables Branch Guard, auto-baselines brownfield debt & detects agents nomos init --local # (Or run a stealth solo trial in .git/info/exclude with clean git status) git switch -c feat/auth # 3. Code & git commit normally; main stays locked and verified

What happens the next time an agent tries taking a shortcut on a feature branch:

$ git commit -m "fix: resolve flaky billing test"

✗ [AntiShimGate] billing_test.go:42 skipped test (t.Skip) + 2 deleted assertions ✗ [UncheckedErr] billing.go:108 discarded error return on ledger.Charge() ✗ [ProtectedRubric] .golangci.yml linter config modified on feature branch -> Commit blocked in 24ms (0 LLM tokens). Fix billing.go without weakening billing_test.go.


Progressive Governance Out of the Box (100% Apache 2.0 Open-Core)

Every single-repository governance capability ships locally in the open-source nomos binary with zero crippled commands, and you adopt complexity only as your repo grows:

1. Zero-Init Brownfield X-Ray & Auto-Baseline (nomos xray, nomos init)
  • Sub-Second Git-Aware Audit (`nomos xray . [--markdown]`): Walks git ls-files across 11 languages for an AI Hangover Score (0-100, Grade A-F), clones, monoliths (>400 LOC), stubs, swallowed errors, secret/host-path leaks, CWE sinks, and ready-to-lock architecture_boundaries with zero repository writes.
  • Drop Into `200k+ LOC` Legacy Repos (`nomos init`): Automatically freezes Day-0 debt bounds in nomos.baseline.json (strict_mode: false on brownfield, strict anywhere via --strict) and ratchets only touched files (<= 0 added complexity/debt, >= 0 coverage delta, 0 new clones or swallowed errors). Self-hosted nomos holds 0/100 Grade A under strict_mode: true.
  • Zero-Footprint Stealth Trial (`nomos init --local`): Registers generated configs and hooks in .git/info/exclude instead of .gitignore, leaving git status clean until you promote with nomos init.
2. Branch Guard First, Isolated Worktrees When Ready (branch vs nomos init --worktrees)
  • **Protected main, Normal feat/* Workflow:** Default isolation_mode: "branch" fails closed on direct main/master writes and config/hook tampering (nomos.yaml, nomos.baseline.json, .git/hooks/*), while plain git commit on feat/* branches runs 42-gate pre-commit verification automatically.
  • Upgrade on Demand (`nomos init --worktrees`): Switch to parallel per-task git worktree sandboxes, cross-branch collision radar, and causal spec-before-code separation anytime (see the Architecture Blueprint below).
3. 42 Polyglot Anti-Cheat AST Gates, SARIF & PR Mutation Proofs (nomos verify)
  • 11 Languages in `~460ms` (`~24ms` Single-File Radar, `0` LLM Tokens): Built-in AST, .scm queries, wazero WASM (Java/C#), and native coverage probes across Go, TypeScript/Svelte, Python, Rust, Ruby, C/C++, Java, Kotlin, and C#.
  • Diff Mutation, SARIF 2.1.0 & PR Receipts (`nomos verify --pr --mutate-diff`, `--sarif`): Mutates added conditionals/returns across Go, TS/JS, and Python so tautological tests fail closed, emits OASIS SARIF 2.1.0 for GitHub Code Scanning, and posts PR receipts via action.yml.
  • Anti-Reward-Hacking Obligations: Blocks deleted/skipped tests (t.Skip, @pytest.mark.skip, #[ignore], xit, @Disabled, [Fact(Skip=...)]), hollow stubs (todo!(), pass, NotImplementedError), functions > 60 LOC (400 LOC file ceiling), directional architecture_boundaries, and strict_types.
4. ~4ms Pre-Tool Security Airlock & Loop Circuit-Breaker (nomos hook)
  • Host Credential & SSRF Firewall: Denies reads of ~/.ssh, ~/.aws, ~/.kube, ~/.gnupg, ~/.config/gcloud, .netrc, .npmrc, .pypirc, blocks cloud metadata SSRF (169.254.169.254), and tracks multi-turn ingress-to-egress taint.
  • Anti-Phantom Stop & 3-Strike Breaker: Rejects unverified "tests pass" claims and halts 3 consecutive non-progressing tool failures before burning context windows.
5. Receipt-Gated Episodic Memory & Read-Only MCP (nomos mem, nomos mcp / mneme.db)
  • Zero-Cloud SQLite Recall & `stdio` MCP (`<50ms`): Pure-Go mneme.db (WAL) pairs AST-scoped pitfalls/patterns with 64-dim subword hashing, lexical ranking, optional local embeddings (LOCAL_EMBEDDING_URL), and read-only JSON-RPC 2.0 exposure via nomos mcp.
  • Verified-Only Distillation (`post-commit`): .git/hooks/post-commit (and 2PC sync in worktree mode) promotes trap-to-fix lessons only after checks pass so broken attempts never poison future runs.
6. Auto-Detected Hooks & Clean 2-Tier CLI (nomos --help)
  • Zero Unwanted Dot-Dir Bloat: nomos init auto-detects installed agents (Claude Code, Cursor, OpenCode, Gemini CLI, Windsurf, or Antigravity; or --agents claude,cursor), scaffolds compact AGENTS.md instructions (~15 lines), and wires native lifecycle + Git hooks.
  • Uncluttered CLI Surface: nomos --help highlights everyday commands (xray, init, verify, status, task, mem, issue, update); nomos --help-agent reveals agent-harness RPCs (hook, handshake, directive, capabilities, physics, session, mcp).

Quick Start (Under 60 Seconds)

1. Install nomos
# Linux, macOS & WSL2 (SHA-256 verified release binary):

curl -fsSL https://sophialabs.ca/install | bash

macOS & Linux (Homebrew):

brew install --cask mgantlett/tap/nomos

Arch Linux / Omarchy (verified PKGBUILD):

(tmp="$(mktemp -d)" && cd "$tmp" && curl -fsSLO https://raw.githubusercontent.com/mgantlett/nomos/main/packaging/aur/PKGBUILD && makepkg -si && rm -rf "$tmp")

Build from source (Go 1.26+; GOTOOLCHAIN=auto fetches Go 1.26+ automatically):

GOTOOLCHAIN=auto CGO_ENABLED=0 go install github.com/mgantlett/nomos/substrate/cmd/nomos@main

Update or cleanly uninstall anytime:

nomos update && nomos update --sync-workspace

curl -fsSL https://sophialabs.ca/uninstall | bash

2. X-Ray & Initialize in Your Preferred Mode
cd your-project

nomos xray . # Step 0: Sub-second read-only AI Hangover Score (or --markdown for PRs/Slack) nomos init # Step 1: Branch Guard + auto-baseline + auto-detected agent hooks (no silent main commit)

nomos init --local # Optional: zero-footprint stealth trial tracked only in .git/info/exclude

3. Code on Normal Feature Branches With Any Agent
git switch -c feat/ttl-cache

Open Claude Code, Cursor, OpenCode, Gemini CLI, or Antigravity:

"Add TTL cache eviction to Store with unit tests"

git add -A && git commit -m "feat: add TTL cache eviction"

pre-commit runs nomos verify (42 gates); post-commit distills lessons into mneme.db

4. Graduate to CI PR Proofs, Parallel Worktrees & Sovereign Governance (Optional)

Install the official Nomos Zero-Trust PR Proof GitHub Action from GitHub Marketplace, or scaffold CI workflows locally:

# Scaffold zero-phone-home GitHub Actions (SARIF) & GitLab CI workflows:

nomos init --ci

Graduate an existing repo to isolated git worktrees & causal INT/SUB task twins:

nomos init --worktrees

# Enforce zero-trust PR mutation proofs in GitHub Actions:
  • uses: actions/checkout@v4 with: { fetch-depth: 0 }
  • uses: mgantlett/nomos@v4.22.1 with: base-ref: origin/main mutate-diff: 'true'

Cheap Workhorse Stack (`OpenCode` + `OpenRouter` / Local `16GB` GPU): Because .opencode/plugins/nomos.ts enforces frontier merge rules in local compiled Go (0 middleman token tax), 14B-32B open-weight models jump from 27.8% to `86.1%` brownfield resolution (3.1x lift) while cutting token spend -43% to -57%.


Why Nomos Is a New Layer of the Stack

What Nomos Is *Not*Why Existing Tools Leave main ExposedWhat the Nomos Transaction Layer Adds
Not Another Coding AgentSwitching models or IDEs does not stop a stochastic optimizer from cutting corners at 70% context.Keep your favorite agent; Nomos enforces sandbox isolation and merge rules underneath it.
Not a Linter or Post-Hoc CITraditional linters assume honest humans *after* a branch is dirty; agents edit configs or add ignore comments.Evaluates feat/* branch or isolated git worktree diffs against main while locking nomos.yaml, baselines, specs, and assertions outside agent write scope.
Not a `.cursorrules` Prompt PackMarkdown rules decay past 60% context, and unverified agent notes poison future sessions.Enforces compiled Go exit codes (exit 1) outside context windows and records mneme.db lessons only after verified merges.

Verified Benchmarks & Runtime Footprint

Reproduce locally in one command: go -C substrate test ./cli -run "TestTraceTrialBench|TestCleanroomPolyglotObligation|TestCleanroomDownstreamVectors" -v

Engineering MetricVerified ResultProof / Suite
Workhorse Brownfield Lift (`N = 108` Paired)`86.1%` (`31/36`) vs. `27.8%` Stock (`3.1x` lift) · `-43%` to `-57%` Tokens14B-32B models across Python/TS/Go; 100% hexagonal purity vs. 0% Stock (cleanroom_obligation_polyglot_stress_test.go)

|

Only the beginning is shown; read the rest in the repo