---
name: nomos
description: Thin binary bootstrapper and remote MCP surface for Nomos (zero-token AST and Git guardrails across 11 languages). Use when asked to audit AI technical debt, prevent test deletion or reward-hacking (t.Skip, hollow stubs, swallowed errors), lock main, baseline a legacy brownfield repo, or inspect public GitHub repos.
---

# Nomos Thin Binary Bootstrapper & Remote MCP Guide

Nomos is a compiled `~20 MB` `CGO_ENABLED=0` static Go binary (`Apache-2.0`, `0` LLM tokens) sitting between coding agents and Git. Never simulate AST gates in Markdown prompts or DIY shell scripts.

## 1. Zero-Install Remote MCP Attachment (Optional)

```bash
claude mcp add --transport http nomos https://sophialabs.ca/mcp
```

## 2. Ensure `nomos` Binary Is Installed Locally

Check `command -v nomos`. If missing, install the SHA-256 verified binary:

```bash
brew install --cask mgantlett/tap/nomos
npx --yes @mgantlett/nomos xray .
curl -fsSL https://sophialabs.ca/install | bash
GOTOOLCHAIN=auto CGO_ENABLED=0 go install github.com/mgantlett/nomos/substrate/cmd/nomos@latest
```

## 3. Run Read-Only Day-0 Audit (`0` Repository Writes) & Initialize Branch Guard

```bash
nomos xray .
nomos init
# Or stealth trial tracked only in .git/info/exclude: nomos init --local
```

- `nomos init` freezes existing legacy debt in `nomos.baseline.json` so zero untouched legacy files fail, protects `main`, and wires `~4ms` native hooks.
- Never run `nomos init --worktrees` on Day 0 unless explicitly requested by the user.
- Resolve any `nomos verify` rejections cleanly without weakening tests (`t.Skip`, deleted assertions, `// TODO` stubs).