fluxflow-cli 1.21.3 → 2.0.0

package/ARCHITECTURE.md

@@ -29,6 +29,16 @@ The execution flow of a single user prompt follows this loop:
    - **Multi-Stage Failover**: The loop features a sophisticated 16-attempt retry engine with exponential backoff (1s - 32s).
    - **Critical Fallback Pivot**: If the primary model fails 14 consecutive times, the agent surgically pivots to a lighter, high-concurrency fallback model (`gemini-3.1-flash-lite`) for the final 3 attempts to ensure session navigation through API congestion.
 
+## The IDE Bridge (Companion Extension)
+
+Flux Flow includes an optional but powerful **IDE Companion** that establishes a real-time link between your code editor (VS Code and forks) and the CLI agent.
+
+- **Sidecar Communication**: The extension starts a WebSocket server on a dedicated local port (`56832`). The CLI agent acts as a client, automatically connecting upon startup.
+- **Bi-Directional Context**:
+    - **CLI → IDE**: When the agent creates a file (`write_file`) or patches code (`update_file`), it sends a command to the editor to automatically open the document and apply green highlights to the newly added lines.
+    - **IDE → CLI**: Before every prompt, the CLI requests a context snapshot. The extension reports the **focused file path**, **cursor line number**, **active text selection**, and **manual user edits** (calculated by diffing the document against its state at the start of the turn).
+- **State Persistence**: The extension maintains `lastKnownStates` for all visible tabs to ensure that only manual human edits are reported back to the AI, preventing redundant context loops.
+
 ## Multimodal Pipeline
 
 Flux Flow implements a native multimodal processing engine in `src/tools/view_file.js`. This allows the agent to move beyond text-based reasoning and analyze visual assets directly (Only on supported models).

package/README.md

@@ -2,7 +2,7 @@
 ![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
 
 <p align="left">
-  <a href="https://github.com/KushalRoyChowdhury/fluxflow-cli"><img src="https://img.shields.io/badge/FluxFlow-v1.21-blue?style=plastic" alt="FluxFlow Version"></a>
+  <a href="https://github.com/KushalRoyChowdhury/fluxflow-cli"><img src="https://img.shields.io/badge/FluxFlow-v2-blue?style=plastic" alt="FluxFlow Version"></a>
   <a href="https://deepmind.google"><img src="https://img.shields.io/badge/Engine-Gemma%204-red?style=plastic" alt="Engine Gemma 4"></a>
   <a href="https://pollinations.ai"><img src="https://img.shields.io/badge/Built%20With-pollinations.ai-cyan?style=plastic" alt="Built With pollinations.ai"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic" alt="License MIT"></a>
@@ -46,6 +46,13 @@ Generate gorgeous, high-fidelity images directly from the command line using [Po
 - **Budget Telemetry**: Real-time credits tracker displayed in sleek high-contrast Ink terminal boxes.
 - **PNG Metadata Embedding**: Autonomously injects custom `tEXt` metadata chunks (Title, Software, Author, Seed, Model, and exact Prompt details) straight into the output image headers.
 
+### 🔌 **High-Fidelity IDE Companion**
+Flux Flow now pairs with a dedicated VS Code extension to bridge the gap between terminal and editor:
+- **Live Context Awareness**: The agent knows exactly which file you are looking at and where your cursor is.
+- **Selection-Driven Reasoning**: Select a block of code in your IDE and ask "What does this do?"—the agent receives your selection instantly.
+- **Native Edit Highlights**: AI code changes appear in real-time as diff viewer inside your editor.
+- **Universal Compatibility**: Works flawlessly with VS Code, Cursor, VSCodium, and Antigravity.
+
 ### 👁️ **Native Multimodality**
 Flux Flow can now see! Use the `view_file` tool to analyze images (JPG, PNG) or deep-dive into PDF technical papers. The agent extracts high-fidelity visual context natively, making it a true multimodal companion.
 
@@ -107,7 +114,7 @@ fluxflow [options]
 - `--update <check|latest>`: Manually run an update check (`check`) or execute latest update setup (`latest`).
 - `--package <npm|pnpm|yarn|bun>`: Override default package manager to run core application updates.
 - `--auto-del <1d|7d|30d>`: Set automated chat log deletion schedule.
-- `--auto-exec <on|off>`: Toggle autonomous command execution permission.
+- `--yolo <on|off>`: Toggle autonomous command execution permission.
 - `--external-access <on|off>`: Toggle permission to let agent read files outside CWD.
 - `--thinking <Fast|Medium|High|xHigh>`: Override default thinking level.
 

package/UI_FEATURES.md

@@ -58,7 +58,7 @@ By default, the agent **cannot** execute dangerous actions without your consent.
 - **Safe Commands**: Basic read-only commands (like `ls`, `git status`, `pwd`) are automatically allowed to minimize friction.
 
 ### Auto-Execution (Advanced)
-For power users, **Auto-Exec** can be enabled in `/settings`.
+For power users, **YOLO Mode** can be enabled in `/settings`.
 - **⚠️ Warning**: This allows the agent to run any tool and execute any command autonomously.
 - **External Access**: You can also toggle whether the agent is allowed to access files outside of its current working directory.
 - **Manual Commad Control**: Specify which commands you want the agent to auto-execute, manually approve or auto-deny.