Flutter Demon
A blazingly fast TUI for Flutter development



Website · Documentation · Keybindings · Configuration

Flutter Demon (fdemon) is a high-performance terminal UI for Flutter development. Run apps, view logs in real-time, hot reload on file changes, and manage multiple device sessions — all from your terminal.

curl -fsSL https://fdemon.dev/install.sh | bash

This downloads the latest release binary for your platform and installs it to $HOME/.local/bin.

The script is also available at https://raw.githubusercontent.com/edTheGuy00/fdemon/main/install.sh if you prefer fetching it straight from the repository.

See the installation guide for version-specific installs, custom directories, Windows, and building from source.

• Real-time log viewing with level/source filtering, regex search, and error navigation
• Native platform logs — Android logcat, iOS, and macOS capture with per-tag filtering (T)
• Auto hot reload on file save with smart debouncing
• Multi-device sessions — run on up to 9 devices simultaneously
• Built-in DevTools — widget inspector, performance monitor, memory panel, network monitor
• New Session Dialog — device selection, launch configs, dart defines, and Android QR pairing
• DAP server — connect your IDE's debugger to fdemon with one keypress
• Flutter SDK management — version manager and toolchain install wizard built in
• Link Highlight Mode — open files from log traces directly in your editor
• Smart project discovery — auto-detects Flutter apps, plugins, and workspaces

cd /path/to/my_flutter_app
fdemon

Select a device, configure launch settings, and press Enter to launch. From the New Session dialog you can also pair a physical Android device over Wi-Fi via QR code (p).

Press d to enter DevTools mode. Four panels are available:

Debug overlays (Ctrl+r repaint rainbow, Ctrl+p performance, Ctrl+d debug paint) and browser DevTools (b) are also available.

Full reference: fdemon.dev/docs/keybindings

Flutter Demon works out-of-the-box with sensible defaults. Optionally configure via:

• .fdemon/config.toml — Behavior, watcher, UI, editor settings
• .fdemon/launch.toml — Launch configurations (device, mode, flavor, dart defines)
• .vscode/launch.json — Auto-imported (read-only)

Full reference: fdemon.dev/docs/configuration

• Flutter SDK in your PATH
• A terminal with Unicode support

Flutter Demon was built using Claude Code with a structured AI-assisted workflow. It follows a structured development process that ensures high code quality through distinct phases. Each feature goes through planning, phased implementation, testing, and review:

flowchart TB
    Research["🔍 Research"] --> Plan["📋 Plan"]
    Plan --> Breakdown["📑 Break into Phases"]
    Breakdown --> Phase1["Phase 1"]
    Breakdown --> Phase2["Phase 2"]
    Breakdown --> PhaseN["Phase N"]

    Phase1 --> Tasks1["📝 Break into Tasks"]
    Tasks1 --> Task1A["Task 1"]
    Tasks1 --> Task1B["Task 2"]
    Tasks1 --> Task1C["Task N"]

    Task1A --> Impl1A["⚙️ Implement"]
    Task1B --> Impl1B["⚙️ Implement"]
    Task1C --> Impl1C["⚙️ Implement"]

    Impl1A --> PhaseTest1["🧪 Test Phase"]
    Impl1B --> PhaseTest1
    Impl1C --> PhaseTest1

    PhaseTest1 --> PhaseReview1["🔎 Review Phase"]
    PhaseReview1 -->|"✅ Pass"| Phase2
    PhaseReview1 -->|"❌ Issues"| Task1A

    Phase2 --> NextPhase["Continue..."]
    PhaseN --> FinalReview["🔎 Final Review"]
    FinalReview -->|"✅ Approved"| Done["✅ Done"]
    FinalReview -->|"❌ Needs Work"| PhaseN

    style Research fill:#e1f5ff
    style Plan fill:#fff4e1
    style Breakdown fill:#fff4e1
    style PhaseTest1 fill:#e8f5e9
    style PhaseReview1 fill:#f3e5f5
    style FinalReview fill:#f3e5f5
    style Done fill:#c8e6c9

Complete AI-assisted development history is maintained in workflow with the following structure:

workflow/
├── plans/
│   ├── features/          # Feature plans with phases and tasks
│   └── bugs/              # Bug reports and fix tasks
└── reviews/
    ├── features/          # Feature implementation reviews
    └── bugs/              # Bug fix reviews

Each task file includes a Completion Summary with:

• Files modified and changes made
• Notable decisions and tradeoffs
• Testing performed and results
• Risks and limitations identified

This transparent development process demonstrates how AI can augment software development while maintaining high code quality, comprehensive testing, and thorough documentation.

On startup, fdemon checks GitHub for newer releases by issuing a single HTTPS request to api.github.com. No personal data is transmitted beyond a User-Agent: fdemon/<version> header and the request itself. Disable this by setting version_check = false under [behavior] in .fdemon/config.toml. See docs/CONFIGURATION.md for full details.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

cargo build && cargo test && cargo clippy

Business Source License 1.1 — free for all use except providing a commercial hosted Flutter development service. Converts to AGPL-3.0 after four years.

Made with 🔥 for Flutter developers