@codacy/verity-cli

CLI for Verity — a compounding quality system for AI-generated code.

Install

npm install -g @codacy/verity-cli
cd your-project
verity init

Then open the project in Claude Code and run /verity-setup.

Permission denied?

If npm install -g fails with EACCES, your npm global directory needs fixing:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc
npm install -g @codacy/verity-cli

Upgrade

npm install -g @codacy/verity-cli@latest

Existing projects keep working — new compound features (knowledge extraction, graph memory, pre-work injection) activate automatically.

Coming from GATE.md (@codacy/gate-cli)?

GATE.md is now Verity. One-time switch:

npm rm -g @codacy/gate-cli
npm install -g @codacy/verity-cli
verity init   # per project — moves .gate→.verity, keeps your token, Standard & memory

No re-setup needed: your token, Standard, and run history all carry over.

Quick reference

| Command | Description | |---------|-------------| | Core | | | verity init | Initialize Verity in current project | | verity analyze | Run analysis on changed files (stop hook) | | verity analyze --mode <mode> | Force analysis mode (standard/plan/debug/skip) | | verity review --files <paths> | On-demand analysis (advisory) | | verity status | Show project quality status | | verity status --history | Show recent run history with findings summary | | verity run <run-id> | Show findings for a specific past run; --json for machine-readable output | | Auth & Config | | | verity login | Log in once with GitHub — grants access to every repository you can write to | | verity login --force | Re-authenticate and refresh your grants (also how stale grants heal) | | verity auth register | Register a single project (per-repo token; superseded by verity login) | | verity token create --name <name> | Mint a service token for CI (--expires <days> optional) | | verity token list | List this repository's tokens (ids and metadata only) | | verity token revoke <id> | Revoke a token by id | | verity sessions list | List your logins — device, last use, expiry (logins expire after 90 days) | | verity sessions revoke <id> | Revoke one login by session id | | verity logout | Sign out on this machine | | verity logout --others | Sign out every OTHER machine (e.g. a lost laptop) | | verity logout --all | Sign out everywhere, including here | | verity hooks install | Wire Claude Code hooks | | verity standard push | Upload project Standard | | Knowledge | | | verity reflect | Trigger knowledge extraction for current task | | verity reflect --user-input "..." | Save a human reflection as a knowledge node | | verity reflect --kind decision | Specify the node kind | | Feedback | | | verity feedback message "text" | Send general feedback | | verity feedback finding <run-id> <pattern-id> <action> | Per-finding feedback | | Tasks | | | verity task list | List tasks | | verity task close | Close the current task (triggers extraction) |

Skills (Claude Code)

| Skill | Description | |-------|-------------| | /verity-setup | Project configuration wizard | | /verity-analyze | On-demand analysis | | /verity-status | Project health dashboard | | /verity-feedback | Feedback (general + per-finding) | | /verity-learn | View and manage project knowledge | | /verity-memory | Browse the knowledge graph | | /verity-insights | Quality metrics + Standard evolution | | /verity-reflect | Capture learnings after a task |

How it works

Prompt → inject knowledge → Agent works → verity analyze → reviewer + knowledge → PASS/FAIL
                                              ↓
                                     extract learnings → .verity/memory/ (graph)
                                              ↓
                                     next prompt starts smarter

The quality gate catches problems. The knowledge system prevents them from recurring. Every analysis run teaches the next one.

Requires Node.js 20+.