Full Review and JSON Output

Codity CLI can run a combined local review and return either human-readable terminal output or machine-readable JSON.

Use this when you want one command to cover review, security, and code quality, or when an automation tool needs parseable results.

Full Review

codity review --full runs three checks for the same diff:

  • AI code review for bugs, regressions, and maintainability issues.
  • Security scanning for vulnerable code patterns, dependency risk, and license risk.
  • Code quality scanning for complexity, maintainability, and anti-patterns.
codity review --full --staged

You can combine --full with the same diff-selection flags as normal review:

codity review --full --all
codity review --full --commit abc1234
codity review --full --branch main

JSON Output

Use --json when another tool needs to parse the result:

codity review --json --staged

For one combined machine-readable result:

codity review --full --json --staged

The JSON output includes:

  • status - Review status, such as completed or no_changes.
  • summary - Human-readable summary of the review.
  • pr_summary - Pull-request style summary when available.
  • comments - Actionable review findings.
  • counts - Total findings and counts by severity.
  • security - Security findings when --full is used.
  • quality - Code quality findings when --full is used.

Example Workflow

git add .
codity review --full --json --staged

Use the JSON output in CI, local scripts, or agent workflows that need structured findings without parsing terminal formatting.

Notes

  • If no changes are found, JSON output returns status: "no_changes" with an empty comments list.
  • Approval-only comments are filtered out so the result focuses on actionable findings.
  • In normal terminal mode, Codity still streams progress and renders findings in a readable format.