Metadata-Version: 2.4
Name: nomos-cli
Version: 4.29.0
Summary: Zero-dependency launcher for Nomos: Apache-2.0 static Go AST & Git execution substrate for AI coding agents (nomos xray, nomos init, nomos verify, nomos mcp).
Author: Mark Gantlett
License-Expression: Apache-2.0
Project-URL: Homepage, https://sophialabs.ca
Project-URL: Documentation, https://sophialabs.ca/docs/introduction
Project-URL: Repository, https://github.com/mgantlett/nomos
Project-URL: Issues, https://github.com/mgantlett/nomos/issues
Keywords: ai-agents,agent-skills,ast,claude-code,code-quality,coding-agents,cursor,git-hooks,git-worktree,guardrails,mcp,mcp-server,model-context-protocol,sarif
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# `nomos-cli`

Zero-dependency Python (`uvx` / `pipx` / `pip`) launcher for [**Nomos**](https://github.com/mgantlett/nomos) (`Apache-2.0`), the compiled static Go AST and Git governance substrate between AI coding agents and production repositories.

## Quick Usage (`uvx` - Zero Install Required)

```bash
# Run a read-only sub-5s AI Hangover Score & AST hotspot audit:
uvx nomos-cli xray .

# Initialize non-breaking Branch Guard & Day-0 brownfield baseline ratchet:
uvx nomos-cli init --local

# Launch the local read-only stdio MCP server:
uvx nomos-cli mcp
```

Or install `nomos` onto your Python environment `PATH`:

```bash
uv tool install nomos-cli
# or: pip install nomos-cli
```

Or attach directly to the zero-install remote Streamable HTTP MCP endpoint:

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

## SHA-256 Integrity Verification

When `nomos` is not already present on `PATH`, `nomos-cli` downloads the official GitHub Release archive (`https://github.com/mgantlett/nomos/releases`) for your OS/CPU (`Linux`/`Darwin`/`Windows`, `x86_64`/`arm64`) using Python's standard library and verifies its SHA-256 digest against the release `checksums.txt` manifest before extracting or executing the binary.

<!-- mcp-name: io.github.mgantlett/nomos -->
