falcon_cli

Dart wrapper for Falcon — Rust-powered static analysis for Flutter & Dart.

30,000+ lines/sec | 61+ rules | AI Code Score | Enterprise HTML reports

Install

dart pub global activate falcon_cli

Prerequisite: Requires the Falcon Rust binary:

cargo install --git https://github.com/viveky259259/falcon

Or download from GitHub Releases.

Quick Start

# Full analysis with HTML report
falcon analyze . --format html --output report.html

# AI Code Quality Score (0-100)
falcon ai-score .

# Compare two branches
falcon compare-branches . --base main --branch feature/my-feature

# View analysis history
falcon history .

# Codebase intelligence
falcon codebase-intel .

# Self-update
falcon update

What Falcon Detects

  • Security: Hardcoded credentials, insecure storage, certificate bypass
  • Error Handling: Empty catches, unawaited futures, async void
  • Type Safety: Dynamic types, missing annotations
  • Complexity: Long functions, deep nesting, god files
  • Performance: Widget rebuild issues, missing const, await-in-loop
  • Flutter: Missing dispose, BLoC anti-patterns, Riverpod issues

Enterprise HTML Reports

falcon analyze . --format html --output report.html

Generates a full dashboard with:

  • Health score gauge and KPI cards
  • Project properties from pubspec.yaml
  • Level of Concern breakdown (8 categories)
  • Test coverage analysis
  • Severity charts and top rules
  • Complexity hotspots with risk badges
  • Issues grouped by file with search and filter
  • Dark/light theme toggle

Branch Comparison

falcon compare-branches . --base main --branch dev --output comparison.html

Analyzes both branches and shows delta: health score, issues, metrics, and rule changes.

Report History

Every falcon analyze auto-saves a snapshot:

falcon history .                              # List all runs
falcon compare-reports . --run1 1 --run2 3    # Compare any two

CI/CD

# GitHub Actions
- run: cargo install --git https://github.com/viveky259259/falcon
- run: falcon analyze . --fail-on error
- run: falcon analyze . --format html --output report.html

All Commands

Category Commands
Analysis analyze, metrics, ai-score, ai-report
Checks check-unused-code, check-cycles, check-widgets, check-async, cognitive-complexity, codebase-intel
Comparison compare-branches, compare-reports, history
AI provenance, conventions, drift, predict, vuln-scan
CI/CD pr-comment, webhook, fix, benchmark
Update update, update --version X, update --list

See the CLI Reference for all flags and options.

License

MIT

Libraries

falcon_cli
Falcon CLI — Rust-powered static analysis for Flutter/Dart.