npm.io
0.24.0 • Published 2d agoCLI

@codacy/verity-cli

Licence
Version
0.24.0
Deps
2
Size
656 kB
Vulns
0
Weekly
0

@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 auth register Register a project
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+.