What is Nomos?
Nomos is an open-source Go tool that sits between a coding agent and Git, adding deterministic checks without replacing the agent or changing the usual feature-branch workflow. It is aimed at developers and teams using AI coding agents who want guardrails around code changes, tests, repository security, and merges. Nomos runs locally and supports several coding agents and programming languages.
Nomos Features:
AST Quality Gates: Its 42 syntax-tree checks catch issues such as skipped tests, deleted assertions, hollow stubs, swallowed errors, and oversized functions before changes are committed.
Branch Protection: Git hooks block direct writes to main and detect changes to protected configuration, hooks, and baselines on feature branches.
Agent Security: Pre-tool hooks restrict access to specified credential files, block cloud-metadata requests, and stop repeated non-progressing failures.
Baseline Ratcheting: The initial scan records existing repository debt so checks can focus on touched files rather than failing the project over pre-existing issues.
Verified Memory: Nomos can save lessons from verified changes in a local SQLite database and retrieve them for later agent sessions.
Isolated Worktrees: An optional worktree mode runs agent edits in separate Git worktrees and supports separating architectural specifications from code tasks.
Codebase Scans: The X-Ray command scans tracked files across 11 languages and reports structural hotspots, including clones, stubs, and possible secret leaks.
Nomos Benefits:
Preserved Tests: Teams can catch attempts to make a change appear successful by removing assertions or skipping failing tests, before those shortcuts reach the main branch.
Familiar Workflow: Developers can keep their existing coding agent, prompts, and feature-branch habits instead of adopting a replacement assistant or a new development process.
Lower Setup Risk: Baseline ratcheting lets teams introduce checks to an older codebase without requiring them to repair every existing issue first.
Local Control: The open-source binary runs locally without an account or LLM tokens for its governance checks, giving teams a way to add controls without routing each check through a model.
Safer Parallel Work: Separate worktrees help reduce interference when multiple agent tasks are underway, while keeping unverified edits away from the main working branch.
Use Cases:
Agent-Assisted Features: Use Nomos while an agent implements a feature so its commits are checked for skipped tests, weakened assertions, stubs, and other flagged changes.
Legacy Code Changes: Introduce checks in a mature repository by recording the current baseline, then applying the debt ratchet to files changed by new work.
Polyglot Monorepos: Run repository checks across projects containing supported languages such as Go, Python, TypeScript, Rust, Java, and C#.
Credential Protection: Add a local security layer when coding agents work in repositories on machines that also contain credentials or cloud configuration files.
Concurrent Agent Tasks: Enable worktree mode when separate agents or tasks need isolated edits, or when specifications should be handled separately from code implementation.

