Falcon Documentation

Falcon is a Rust-powered static analysis and app management tool for Flutter/Dart. It analyzes code quality, enforces architecture, manages dependencies, predicts production risks, and integrates with AI tools — all in under 2 seconds.

Quick Install

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

Quick Start

$ falcon x manage health .

  falcon x manage Project Health — my_app
  ═══════════════════════════════════════

  Overall Health: 72/100 (Grade: C)

    Code Quality       72/100 ██████████████░░░░░░ (30%)
    Security          100/100 ████████████████████ (20%)
    Performance        85/100 █████████████████░░░ (15%)
    Maintainability    60/100 ████████████░░░░░░░░ (15%)
    Test Coverage      45/100 █████████░░░░░░░░░░░ (10%)
    Dependencies       90/100 ██████████████████░░ (10%)

What's in the docs

Getting Started — Install Falcon, run your first analysis, configure falcon.yaml
CLI Reference — All 80+ commands organized by category with examples
Rule Catalog — 61+ lint rules with severity, descriptions, and code examples
HTML Reports — Enterprise dashboard with health gauge, charts, test coverage, and project properties
Branch Comparison — Compare branches, view history, and track quality over time
AI Features — AI Score, provenance detection, drift analysis, risk prediction
App Management — Health dashboard, dependency manager, architecture governor, maintenance advisor
CI/CD — GitHub Actions, GitLab CI, PR comments, webhooks
Integrations — MCP server, HTTP API, Rust SDK, LSP, partner program
Enterprise — Policies, audit logs, compliance reports, certification

Key Commands

Command	Description
`falcon check`	Full static analysis (61+ rules) with auto-save to history
`falcon check --format html`	Enterprise HTML report with dashboard, charts, and dark/light theme
`falcon x compare-branches`	Compare two git branches side-by-side with delta report
`falcon x history`	View all stored analysis runs
`falcon x compare-reports`	Compare any two stored runs from history
`falcon score`	AI Code Quality Score with 6-dimension breakdown
`falcon x codebase-intel`	Health score, god files, hotspots, tech debt estimate
`falcon x manage health`	Unified project health dashboard (0-100)
`falcon x update`	Self-update to latest or specific version
`falcon x mcp`	MCP server for AI tool integration

Links

GitHub · pub.dev · Landing Page