Everything you need to run Norma
Start with the CLI, then wire it into CI. Each card below is a real guide. Deeper references are on the way.
norma check and norma fix
Install, run a check locally, scope to a diff, set a threshold, and generate fixes with the repair prompt.
Gate every pull request
Drop norma-sh/norma into a workflow to score PRs, post a sticky comment, and fail below your threshold.
norma.config.json
Choose spec globs, includes and excludes, threshold, model, and provider. Anthropic and OpenAI are both supported.
The open report schema
Terminal, markdown, and JSON output. Every report stamps the model and prompt version and conforms to a published schema.
Explanations and repair prompts
How Norma turns a finding into an explanation, ordered fix steps, and a prompt you can paste into a coding agent.
Verify inside your agent
A local MCP server exposing norma_check and norma_fix to an AI coding agent. Experimental.
Programmatic access
A hosted API for running checks and pulling reports into your own tools and dashboards.
Coming soonOne command. Or one workflow.
terminal# install once, then run on any repo with a spec $ npm i -g @norma-sh/norma $ export ANTHROPIC_API_KEY=sk-... $ norma check # no install needed: npx @norma-sh/norma check Spec Fidelity Score 55/100 drift located, per requirement
.github/workflows/norma.ymlon: pull_request steps: - uses: norma-sh/norma@v1 with: threshold: "80" anthropic-api-key: ${{ secrets... }}