flutter-dev 0.1.8__tar.gz → 0.1.10__tar.gz

{flutter_dev-0.1.8 → flutter_dev-0.1.10}/.env.example

@@ -1,26 +1,25 @@
 # AI API Keys Configuration
-# সব API keys এখানে secure ভাবে রাখুন
-# এই file টি .gitignore এ add করতে হবে
+# API keys secure রাখুন এবং কারও সঙ্গে share করবেন না
 
-# Groq API (Current - Active)
-GROQ_API_KEY=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
+# Groq API
+GROQ_API_KEY=
 GROQ_API_URL=https://api.groq.com/openai/v1/chat/completions
 GROQ_MODEL=llama-3.3-70b-versatile
 
 # Mistral AI API
-MISTRAL_API_KEY=irrmymmw43lvCcARy08R1TZhHuqMgXwa
+MISTRAL_API_KEY=
 MISTRAL_API_URL=https://api.mistral.ai/v1/chat/completions
-MISTRAL_MODEL=mistral-medium
+MISTRAL_MODEL=mistral-medium-latest
 
 # SambaNova API
-SAMBANOVA_API_KEY=c5c3f0dc-75db-4621-9d0c-7372efb4a04f
+SAMBANOVA_API_KEY=
 SAMBANOVA_API_URL=https://api.sambanova.ai/v1/chat/completions
 SAMBANOVA_MODEL=Meta-Llama-3.3-70B-Instruct
 
 # OpenRouter API
-OPENROUTER_API_KEY=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
+OPENROUTER_API_KEY=
 OPENROUTER_API_URL=https://openrouter.ai/api/v1/chat/completions
 OPENROUTER_MODEL=openai/gpt-3.5-turbo
 
 # Default AI Service (groq, mistral, sambanova, openrouter)
-DEFAULT_AI_SERVICE=groq
+DEFAULT_AI_SERVICE=groq

{flutter_dev-0.1.8 → flutter_dev-0.1.10}/CHANGELOG.md

@@ -2,47 +2,60 @@
 
 All notable changes to this project are documented in this file.
 
-## 0.1.8 - 2026-06-25
+## 0.1.10 - 2026-07-16
 
-### Fixed
+### Added
 
-- Made the dashboard command output panel visibly framed with a ready message so the terminal/log area does not appear missing before commands produce output.
+- Added `fdev init` to create or repair persistent AI configuration with safe provider defaults and empty API-key fields.
+- Added interactive hidden API-key entry and default/custom model selection when AI configuration is incomplete.
+- Added `fdev ai <provider> <model>` for changing a provider's model without replacing its API key.
+- Added Python coverage for configuration precedence, dotenv parsing, atomic updates, cancellation, permissions, platform paths, and doctor status.
 
-## 0.1.7 - 2026-06-25
+### Changed
+
+- Unified `fdev ai`, `fdev doctor`, `gemini-api`, and `fdev commit` around the same persistent AI configuration resolver.
+- Updated the default Mistral model to `mistral-medium-latest`.
+- Limited build-output directory creation to commands that use those directories.
 
 ### Fixed
 
-- Reworked the Tkinter dashboard to use classic Tk widgets with explicit colors so `fdev` stays visible on macOS Xcode/system Python runtimes that can render `ttk` widgets as a blank popup.
-- Silenced the macOS system Tk deprecation warning before launching the dashboard.
+- Removed credentials from `.env.example` and replaced them with empty API-key values.
+- Made AI configuration writes atomic and restricted the generated file to the current user on Unix-like systems.
+- Cancelled AI setup without saving a partial key or sending a request when interrupted during key/model entry.
+- Prevented exported provider/model overrides from being reported as successfully replaced by file-only changes.
 
-## 0.1.6 - 2026-06-25
+## 0.1.9 - 2026-07-14
 
 ### Added
 
-- Added `fdev upgrade` to update the local `flutter-dev` package from PyPI after detecting the current OS.
-- Added `fdev delete` to uninstall the local `flutter-dev` package after detecting the current OS and confirming the destructive action.
+- Added `fdev mirror --turn-screen-off` to keep mirroring while the physical Android display is off.
 
 ### Changed
 
-- `fdev upgrade` and `fdev delete` now print the exact Python executable they target before running `sys.executable -m pip`.
+- Running `fdev` without a command now prints command help.
+- `fdev clear-data` now skips confirmation when the foreground Android app matches the current Flutter project and uses a default-Yes prompt when it does not.
+- `fdev upgrade` now prints the current installed version, Python environment, package location, upgrade source, and verified result version.
 
-### Fixed
+### Removed
 
-- Reworked the Tkinter dashboard layout to avoid platform-sensitive paned-window sizing that could open a blank `fdev` popup after installing from PyPI.
+- Removed obsolete desktop-only components and their related tests and documentation.
 
-## 0.1.5 - 2026-06-24
+## 0.1.6 - 2026-06-25
 
 ### Added
 
-- Added a Tkinter desktop dashboard that opens by running `fdev` with no command.
-- Added GUI live log output with ANSI terminal color rendering.
-- Added GUI buttons for all documented command groups, including mirror variants, AI provider shortcuts, and GitHub account subcommands.
-- Added Python coverage for GUI command catalog, ANSI color parsing, and no-command CLI dispatch.
+- Added `fdev upgrade` to update the local `flutter-dev` package from PyPI after detecting the current OS.
+- Added `fdev delete` to uninstall the local `flutter-dev` package after detecting the current OS and confirming the destructive action.
+
+### Changed
+
+- `fdev upgrade` and `fdev delete` now print the exact Python executable they target before running `sys.executable -m pip`.
+
+## 0.1.5 - 2026-06-24
 
 ### Changed
 
 - Kept command help available through `fdev help`, `fdev --help`, and `fdev -h`.
-- Documented Tkinter requirements for the desktop dashboard.
 
 ## 0.1.4 - 2026-06-15
 

{flutter_dev-0.1.8 → flutter_dev-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.8
+Version: 0.1.10
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -42,7 +42,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.8`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.10`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -53,7 +53,6 @@ Current package metadata declares version `0.1.8`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
-- Small Tkinter desktop dashboard opened by running `fdev` with no command, with a framed live command output panel.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
@@ -73,8 +72,6 @@ fdev doctor
 
 `python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
-The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
-
 ### Install From Source
 
 ```bash
@@ -122,14 +119,13 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
-| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
-# Open the desktop dashboard
+# Show command help
 fdev
 
 # Show command help
@@ -141,6 +137,9 @@ fdev upgrade
 # Check environment and optional tools
 fdev doctor
 
+# Initialize persistent AI configuration
+fdev init
+
 # Generate localization files
 fdev lang
 
@@ -202,11 +201,12 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app, asks for confirmation, and runs `adb shell pm clear <package>` on Android. iOS prints manual options. |
+| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
 | `fdev mirror --no-top` | Launches `scrcpy` without the always-on-top flag. |
+| `fdev mirror --turn-screen-off` | Launches `scrcpy` while keeping the Android device display turned off. |
 | `fdev datetime` | Disables Android auto-time and opens Date & Time settings on the selected device. |
 
 When multiple Android devices are connected, device-aware commands prompt you to choose a device.
@@ -239,13 +239,15 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
-| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
-| `fdev help` | Shows command help without opening the dashboard. |
+| `fdev` | Shows command help. |
+| `fdev help` | Shows command help. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
-| `fdev upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev init` | Creates or repairs the persistent AI `.env` with safe provider defaults and empty API keys. |
+| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
 | `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
+| `fdev ai <provider> <model>` | Switches provider when needed and saves a custom model ID for that provider. |
 | `fdev brew` | Interactive Homebrew package manager for viewing packages, uninstalling with cleanup, clearing cache, and global cleanup. |
 | `fdev merge` | Reads paths from `paths.txt`, merges file contents into `path_merge_files.txt`, and opens the result when there are no failures. |
 | `gemini-api` | Tests the currently selected AI provider configuration. |
@@ -269,7 +271,7 @@ GROQ_MODEL=llama-3.3-70b-versatile
 
 MISTRAL_API_KEY=your_mistral_api_key_here
 MISTRAL_API_URL=https://api.mistral.ai/v1/chat/completions
-MISTRAL_MODEL=mistral-medium
+MISTRAL_MODEL=mistral-medium-latest
 
 SAMBANOVA_API_KEY=your_sambanova_api_key_here
 SAMBANOVA_API_URL=https://api.sambanova.ai/v1/chat/completions
@@ -286,26 +288,47 @@ The AI runtime searches for configuration in this order:
 
 1. `FLUTTER_DEV_ENV`
 2. `$XDG_CONFIG_HOME/flutter-dev/.env`
-3. `~/.config/flutter-dev/.env`
-4. `~/scripts/flutter-tools/.env`
-5. `.env` beside the installed module/source
-6. `.env` in the current working directory
+3. `%APPDATA%/flutter-dev/.env` on Windows, otherwise `~/.config/flutter-dev/.env`
+4. The legacy `~/.config/flutter-dev/.env` path on Windows
+5. `~/scripts/flutter-tools/.env`
 
 Recommended setup:
 
 ```bash
-mkdir -p ~/.config/flutter-dev
-nano ~/.config/flutter-dev/.env
+fdev init
 ```
 
-Then test:
+`fdev init` never writes real credentials. It creates all provider URL/model
+defaults with empty API-key fields, preserves existing values, and restricts the
+file to the current user on Unix-like systems. On macOS and Linux the default
+path is `~/.config/flutter-dev/.env`.
+
+Then select a provider and test:
 
 ```bash
-fdev ai
+fdev ai mistral
 gemini-api
 ```
 
-Note: the current `fdev doctor` `.env` check is more limited than the AI runtime lookup. If `doctor` reports a missing `.env` but `gemini-api` succeeds, the AI configuration is still usable.
+If the selected provider's key is missing, `fdev commit` or `gemini-api` asks
+for it using hidden terminal input and saves it to the active configuration.
+After a new key is entered, press Enter to use the displayed default model or
+enter another model ID for the same provider. Exported environment variables
+continue to take precedence over values stored in `.env`.
+
+Pressing `Ctrl+C` during key/model setup cancels the operation without saving a
+partial key or sending an AI request. If an exported variable conflicts with a
+provider/model change, `fdev` reports the override and asks you to unset it
+instead of claiming that the file change became active.
+
+Change the model later without replacing the API key:
+
+```bash
+fdev ai groq llama-3.1-8b-instant
+```
+
+`fdev doctor`, `fdev ai`, `gemini-api`, and `fdev commit` use the same persistent
+configuration lookup.
 
 ## Feature/Page Generation
 
@@ -390,11 +413,12 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` clears app data on Android after confirmation.
+- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
 - `fdev upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.
 - `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
-- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- `fdev` with no command prints command usage.
 - Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
@@ -433,18 +457,6 @@ fdev delete
 
 Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
 
-### Blank Dashboard On macOS
-
-If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
-
-```bash
-fdev upgrade
-```
-
-`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
-
-If the dashboard opens but the command output area looks missing or empty, upgrade to `flutter-dev` 0.1.8 or newer.
-
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.
@@ -480,8 +492,12 @@ Install or repair `scrcpy`:
 ```bash
 fdev install-scrcpy
 fdev mirror
+fdev mirror --turn-screen-off
 ```
 
+`--turn-screen-off` may be combined with `--no-top`. The mirrored window stays
+active, but the physical Android display is turned off on supported devices.
+
 For wireless mirroring, connect the device over USB first:
 
 ```bash

{flutter_dev-0.1.8 → flutter_dev-0.1.10}/README.md

@@ -8,7 +8,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.8`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.10`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -19,7 +19,6 @@ Current package metadata declares version `0.1.8`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
-- Small Tkinter desktop dashboard opened by running `fdev` with no command, with a framed live command output panel.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
@@ -39,8 +38,6 @@ fdev doctor
 
 `python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
-The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
-
 ### Install From Source
 
 ```bash
@@ -88,14 +85,13 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
-| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
-# Open the desktop dashboard
+# Show command help
 fdev
 
 # Show command help
@@ -107,6 +103,9 @@ fdev upgrade
 # Check environment and optional tools
 fdev doctor
 
+# Initialize persistent AI configuration
+fdev init
+
 # Generate localization files
 fdev lang
 
@@ -168,11 +167,12 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app, asks for confirmation, and runs `adb shell pm clear <package>` on Android. iOS prints manual options. |
+| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
 | `fdev mirror --no-top` | Launches `scrcpy` without the always-on-top flag. |
+| `fdev mirror --turn-screen-off` | Launches `scrcpy` while keeping the Android device display turned off. |
 | `fdev datetime` | Disables Android auto-time and opens Date & Time settings on the selected device. |
 
 When multiple Android devices are connected, device-aware commands prompt you to choose a device.
@@ -205,13 +205,15 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
-| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
-| `fdev help` | Shows command help without opening the dashboard. |
+| `fdev` | Shows command help. |
+| `fdev help` | Shows command help. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
-| `fdev upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev init` | Creates or repairs the persistent AI `.env` with safe provider defaults and empty API keys. |
+| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
 | `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
+| `fdev ai <provider> <model>` | Switches provider when needed and saves a custom model ID for that provider. |
 | `fdev brew` | Interactive Homebrew package manager for viewing packages, uninstalling with cleanup, clearing cache, and global cleanup. |
 | `fdev merge` | Reads paths from `paths.txt`, merges file contents into `path_merge_files.txt`, and opens the result when there are no failures. |
 | `gemini-api` | Tests the currently selected AI provider configuration. |
@@ -235,7 +237,7 @@ GROQ_MODEL=llama-3.3-70b-versatile
 
 MISTRAL_API_KEY=your_mistral_api_key_here
 MISTRAL_API_URL=https://api.mistral.ai/v1/chat/completions
-MISTRAL_MODEL=mistral-medium
+MISTRAL_MODEL=mistral-medium-latest
 
 SAMBANOVA_API_KEY=your_sambanova_api_key_here
 SAMBANOVA_API_URL=https://api.sambanova.ai/v1/chat/completions
@@ -252,26 +254,47 @@ The AI runtime searches for configuration in this order:
 
 1. `FLUTTER_DEV_ENV`
 2. `$XDG_CONFIG_HOME/flutter-dev/.env`
-3. `~/.config/flutter-dev/.env`
-4. `~/scripts/flutter-tools/.env`
-5. `.env` beside the installed module/source
-6. `.env` in the current working directory
+3. `%APPDATA%/flutter-dev/.env` on Windows, otherwise `~/.config/flutter-dev/.env`
+4. The legacy `~/.config/flutter-dev/.env` path on Windows
+5. `~/scripts/flutter-tools/.env`
 
 Recommended setup:
 
 ```bash
-mkdir -p ~/.config/flutter-dev
-nano ~/.config/flutter-dev/.env
+fdev init
 ```
 
-Then test:
+`fdev init` never writes real credentials. It creates all provider URL/model
+defaults with empty API-key fields, preserves existing values, and restricts the
+file to the current user on Unix-like systems. On macOS and Linux the default
+path is `~/.config/flutter-dev/.env`.
+
+Then select a provider and test:
 
 ```bash
-fdev ai
+fdev ai mistral
 gemini-api
 ```
 
-Note: the current `fdev doctor` `.env` check is more limited than the AI runtime lookup. If `doctor` reports a missing `.env` but `gemini-api` succeeds, the AI configuration is still usable.
+If the selected provider's key is missing, `fdev commit` or `gemini-api` asks
+for it using hidden terminal input and saves it to the active configuration.
+After a new key is entered, press Enter to use the displayed default model or
+enter another model ID for the same provider. Exported environment variables
+continue to take precedence over values stored in `.env`.
+
+Pressing `Ctrl+C` during key/model setup cancels the operation without saving a
+partial key or sending an AI request. If an exported variable conflicts with a
+provider/model change, `fdev` reports the override and asks you to unset it
+instead of claiming that the file change became active.
+
+Change the model later without replacing the API key:
+
+```bash
+fdev ai groq llama-3.1-8b-instant
+```
+
+`fdev doctor`, `fdev ai`, `gemini-api`, and `fdev commit` use the same persistent
+configuration lookup.
 
 ## Feature/Page Generation
 
@@ -356,11 +379,12 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` clears app data on Android after confirmation.
+- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
 - `fdev upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.
 - `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
-- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- `fdev` with no command prints command usage.
 - Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
@@ -399,18 +423,6 @@ fdev delete
 
 Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
 
-### Blank Dashboard On macOS
-
-If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
-
-```bash
-fdev upgrade
-```
-
-`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
-
-If the dashboard opens but the command output area looks missing or empty, upgrade to `flutter-dev` 0.1.8 or newer.
-
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.
@@ -446,8 +458,12 @@ Install or repair `scrcpy`:
 ```bash
 fdev install-scrcpy
 fdev mirror
+fdev mirror --turn-screen-off
 ```
 
+`--turn-screen-off` may be combined with `--no-top`. The mirrored window stays
+active, but the physical Android display is turned off on supported devices.
+
 For wireless mirroring, connect the device over USB first:
 
 ```bash