fluxflow-cli 1.9.30 → 1.10.1

package/README.md

@@ -1,6 +1,14 @@
 # 🌌 Flux Flow (`fluxflow-cli`)
 ![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.10.0-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>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-%3E%3D20-green?style=plastic" alt="Node Compatibility"></a>
+</p>
+
 ### *The High-Fidelity Agentic Terminal for the Flux Era.*
 
 **Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by the latest Gemini/Gemma frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
@@ -29,6 +37,12 @@ fluxflow-cli
 Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
 - **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
 
+### 🎨 **Creative & Visual Sovereignty**
+Generate gorgeous, high-fidelity images directly from the command line using [Pollinations AI](https://pollinations.ai). Use the `/image` command or ask the agent to create visuals. Features:
+- **Customizable Presets**: Supports models like Flux, ZImage, Qwen, and Nanobanana-Pro, custom aspect ratios, and randomized seeds.
+- **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.
+
 ### 👁️ **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.
 

package/TOOLS.md

@@ -8,9 +8,10 @@ Flux Flow provides a robust set of tools that allow the AI to interact with the
 | :--- | :---: | :---: |
 | **Web Search** | ✅ | ✅ |
 | **Web Scrape** | ✅ | ✅ |
-| **Write PDF** | ✅ | ✅ |
-| **Write DOCX** | ✅ | ✅ |
-| **Write PPTX** | ✅ | ✅ |
+| **Generate Image** | ✅ | ❌ |
+| **Write PDF** | ✅ | ❌ |
+| **Write DOCX** | ✅ | ❌ |
+| **Write PPTX** | ✅ | ❌ |
 | **View/Read Files** | ✅ | ❌ |
 | **Write/Update Files** | ✅ | ❌ |
 | **Execute Commands** | ✅ | ❌ |
@@ -32,6 +33,11 @@ Flux Flow provides a robust set of tools that allow the AI to interact with the
   - **Rich Styling**: Supports CSS-like properties (color, font-size, text-align) for professional slide design.
   - **Flat Protocol**: Optimized for AI stability using a flat HTML string interface.
 
+### 🎨 Creative & Visual
+- **`generate_image`**: Generates high-fidelity images using Pollinations AI.
+  - **Customization**: Supports customizable models (Flux, ZImage, Qwen, Nanobanana-Pro, etc.), aspect ratios, custom prompt generation, and random seeds.
+  - **Telemetry**: Tracks hourly credit usage (Low, Medium, Ultra, Premium tiers) with built-in daily limit checks and interactive dashboard displays.
+
 ### 📁 File System Operations
 - **`list_files`**: Lists the contents of a directory to help the agent understand the project structure.
 - **`read_folder`**: Provides detailed statistics and metadata about a directory's contents.