Skip to content

CLI Reference

Main Commands

dino brief

Generate a review brief for the host coding agent (step 1). Selects files and matching rules and emits the instructions the agent needs to perform the analysis itself. No LLM API is called.

In --diff mode the brief marks each file's changed line ranges (or flags new files) so the agent focuses its review on what actually changed.

# Brief for changed files (preferred in the skill workflow)
dino brief --diff -o .dinocheck/brief.md

# Brief for specific paths
dino brief src/

# Machine-readable brief
dino brief --format json

# Embed file contents (for agents without file access)
dino brief --embed-code

# Restrict packs or rules
dino brief --pack django
dino brief --rule n-plus-one

dino report

Validate and score the agent's findings (step 2). Reads the results JSON produced from a brief, validates it against the output contract, deduplicates, scores, caches, and prints the formatted result.

dino report .dinocheck/results.json
dino report results.json --format json
dino report results.json -o review.txt

# CI gating: exit 1 if issues at this severity or above survive validation
dino report results.json --fail-on critical

Validation problems are reported precisely (exit code 2) so the agent can fix the JSON and retry. Findings that cite rules not listed in the brief for that file, or point outside the file's line range, are dropped with a warning.

dino init

Create a dino.yaml configuration file.

dino init

If agent folders (.claude, .codex, .gemini) exist, it will offer to create skills.

dino skill

Create agent skills for AI coding assistants.

# Auto-detect and create for all agents
dino skill

# Create for specific agent
dino skill --agent claude
dino skill --agent codex
dino skill --agent gemini

# Force overwrite existing
dino skill --force

See Coding Agents for full documentation.

dino version

Show version information.

dino version

Pack Commands

dino packs list

List all available rule packs.

dino packs list

dino packs info

Show details of a specific pack.

dino packs info python
dino packs info django

dino explain

Explain a specific rule.

dino explain django/n-plus-one
dino explain python/mutable-default

Cache Commands

dino cache stats

Show cache statistics.

dino cache stats

dino cache clear

Clear the analysis cache.

dino cache clear

Log Commands

dino logs list

View analysis run history.

dino logs list

dino logs show

Show details of a specific analysis run.

dino logs show 123

Command Summary

Command Description
dino brief [paths] Generate a review brief for the host agent
dino brief --diff Brief covering only changed files
dino brief --embed-code Include file contents in the brief
dino brief --debug Enable debug logging to dino.log
dino report FILE Validate, score, and cache agent findings
dino report FILE --fail-on LEVEL Exit 1 on issues at/above a severity
dino packs list List available packs
dino packs info NAME Show pack details
dino explain RULE_ID Explain a rule
dino cache stats Show cache statistics
dino cache clear Clear the cache
dino logs list View analysis run history
dino logs show ID Show details of a specific run
dino init Create dino.yaml
dino skill Create agent skills
dino skill --agent NAME Create skill for specific agent
dino version Show version information