\n\n### One of the lightest, fastest, high-fidelity agentic CLI with sub-agents & computer use.\n#### *Only ~590 tokens total system prompt with tools.*\n\n๐ **[Official Documentation](https://fluxflow-cli.onrender.com/)**\n\n**Flux Flow** is not just another CLI-it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by multi-provider frontier models (Google Gemini, DeepSeek, OpenRouter, and more). Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.\n\n---\n\n## ๐ Instant Ignition (No Setup Required)\nYou don't even need to install it. Just fire up your terminal and run:\n\n```bash\n# Run instantly (Zero Setup)\nnpx fluxflow-cli\n\n# OR Install Globally\nnpm install -g fluxflow-cli\nfluxflow-cli\n```\n\n*The agent will prompt you for your API Key on the first run and store it securely in an encrypted vault.*\n\n- **Multi-Provider Support**: Choose your preferred engine!\n - **Google GenAI**\n - **DeepSeek**\n - **NVIDIA**\n - **Ollama**\n - **Mistral**\n - **CrofAI** (*Removed from v4.16 onwards*)\n - **InferX**\n - **SenseNovaAI**\n - **Poolside**\n - **Token Harbor**\n - **APInex**\n - **Experimental Labs** (*Experimental*)\n - **9Router** (*Experimental*)\n - **AIHubMix** (*Experimental*)\n - **OpenRouter** (*Experimental*)\n\n---\n\n## โจ Why Flux Flow?\n\n### ๐จ **Premium Visual Sovereignty**\nExperience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:\n- **Dynamic Status Bar**: Real-time telemetry showing your \"Neural Headroom\" (token usage), Thinking Level, and Session ID.\n\n### ๐ **High-Fidelity IDE Companion**\nFlux Flow now pairs with a dedicated VS Code extension to bridge the gap between terminal and editor:\n- **Surgical Diagnostic Sync**: Proactive background scanning for errors. If your project breaks, a \"Magic Wand\" icon $(\\text{sparkle})$ appears in your editor title bar for an instant AI fix.\n- **Live Status Heartbeat**: The VS Code Status Bar acts as a live feed, showing the agent's current task (*Thinking*, *Web Searching*, *Patching*, etc.).\n- **Clickable Terminal Links**: Jump from the terminal output straight to your code with clickable file:line links.\n- **Right-Click Integration**: \"FluxFlow > Chat\" is available in the editor, explorer, and tab bars, even when no files are open.\n- **Selection-Driven Reasoning**: Select a block of code and ask \"What does this do?\"-the agent receives your selection instantly.\n- **Universal Compatibility**: Works flawlessly with VS Code, Cursor, VSCodium, Trae, and Antigravity.\n\n### ๐๏ธ **Native Multimodality**\nFlux Flow can now see (supported models only)! 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.\n\n### ๐ **Document Engineering Suite**\nNeed a report or a presentation? Just ask. Flux Flow features a high-fidelity \"Printing Press\" that generates professional, branded documents natively:\n- **PDF**: Branded documents from HTML/CSS with automatic watermarking.\n- **DOCX**: Native Word documents with multi-page support and automatic numbering.\n\n### โฑ๏ธ **Codebase Time Travel (Git-less Reversion)**\nRefactor and build with absolute fearlessness. Flux Flow maintains transaction-based secure snapshots of files before they are generated or edited:\n- **Instant Rollback**: Revert your workspace files (source code, generated documents, images) to their exact state prior to any selected prompt in the history.\n- **Double-ESC Shortcut**: Press `ESC` twice while idle to pop open a sleek selection modal.\n- **`/revert` Command**: Run the `/revert` command directly in the chat to open the checkpoint viewer.\n\n### ๐ **Self-Healing Infrastructure**\nZero setup means zero setup. On first run, Flux Flow performs an integrity check and autonomously installs its own Chromium engine if needed, ensuring features like PDF generation work 100% of the time without manual intervention.\n\n- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.\n- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.\n\n### ๐ง **The Dual-Intelligence System**\n- **Flux Mode (Workspace)**: High-speed, agentic problem solving for massive coding tasks.\n- **Flow Mode (Creative Studio)**: Optimized for high-quality conversation and web-assisted reasoning.\n- **Computer Use (GUI Automation)**: Agents can control computer GUI, with mouse and keyboard.\n- **FluxCU/Omni (Autonomous Workflow Engine)**: Agents can control computer GUI for automated workflows and tasks, with mouse and keyboard.\n\n### ๐ก๏ธ **Digital Fortress Governance**\nSecurity isn't an afterthought; it's a boundary.\n- **Sandbox Presets**: Choose from **Strict**, **Balanced**, **Autonomous**, or **Custom** security profiles to control agent autonomy.\n- **Granular Command Policies**: Configure Auto-Approve (`Auto` / `Read-Only` / `None`), Auto-Disallow (`Auto` / `Destructive` / `None`), Network Access toggle, and Auto-Approve Git Commits independently.\n- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.\n- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.\n\n### ๐งน **The Background Janitor**\nWhile you move at high speed, the Janitor follows behind-refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.\n\n### ๐ค **Autonomous Subagent System**\nDelegate complex tasks to subagents. Spawns blocking subagents (`invokeSync`) or asynchronous background subagents (`invoke`) with distinct telemetry and silent background logging. Built-in transaction-safe reversion logs all subagent changes under the active turn, preserving rollback security.\n\n---\n\n## ๐ ๏ธ Key Capabilities\n- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.\n- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.\n- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.\n\n- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.\n\n---\n\n## ๐ป CLI Startup Arguments\nCustomize your session parameters directly from your console launch command:\n\n```bash\nfluxflow [options]\n```\n\n### Supported Flags:\n - `--model `: Temporary override for the active AI model (e.g., `gemini-3.7-flash`). Keeps settings file untouched.\n - `--cwd `: Set the working directory for the session (relative or absolute path).\n - `--path `: Alias for `--cwd`. Set the working directory for the session.\n - `--memory `: Toggle persistent long-term agent memory for the session. [Legacy. Deprecated]\n - `--resume `: Resume a previous chat session programmatically.\n - `--update `: Manually run an update check (`check`) or execute latest update setup (`latest`).\n - `--package `: Override default package manager to run core application updates.\n - `--auto-del <1d | 7d | 30d>`: Set automated chat log deletion schedule.\n - `--yolo `: Toggle autonomous execution permission.\n - `--external-access `: Toggle permission to let agent read files outside CWD.\n - `--thinking `: Override thinking level for reasoning depth. `Medium` and `Standard` is the same (Deepseek compatibility).\n - `--key `: Set API key and provider.\n - `--provider `: Override default provider.\n - `--usage`: Launches the usage dashboard in your browser.\n\n----\n\n## โ๏ธ Configuration\nType `/settings` in-app to live-configure:\n- **Thinking Level**: Fast (No Reasoning), Low, Medium, High, xHigh (Extended Reasoning).\n- **Sandbox Preset**: Strict, Balanced, Autonomous, or Custom security profiles.\n- **Security Perimeter**: Toggle External Workspace access, Network Access, and Git Commit auto-approval.\n\n---\n\n## ๐ง Configurable Environment Variables\nSet these in your shell/session to override defaults:\n- `SUBAGENT_MODEL` - Subagent model override (e.g., `gemini-2.5-pro`)\n- `SUBAGENT_PROVIDER` - Subagent provider override (e.g., `google`, `deepseek`)\n- `SUBAGENT_THINKING` - Thinking level overide for subagents. [Fast, Low (default), Medium, High]\n- `NVIDIA_BASE_URL` - Custom NVIDIA endpoint URL\n- `NVIDIA_API_KEY` - NVIDIA API key (used when `NVIDIA_BASE_URL` is set)\n- `OLLAMA_HOST` - Ollama endpoint (default: `http://127.0.0.1:11434`)\n- `SHELL` - Preferred shell for command execution (default: `bash`)\n- `HIGH_CONTEXT` - Context window override (`false` or integer `32000` to `1000000`) [Deprecated!]\n- `SHOW_DEBUG_GRID` - true|false, default: false\n- `DEBUG_OCR` - true|false, default: false\n- `NO_DEV` - true|false, default: false\n- `EXPERIMENTAL_MEMORY_MANAGER` - true|false, default: false\n- `I_HAVE_TOO_MUCH_MONEY` - true|false, default: false, F's up the cache-hit ratio\n- `GOOGLE_GEMMA_NONSENSE` - true|false, default: false, for the 16k TPM limit in gemma models on gemini API. False defaults to 256k\n- `ENABLE_9ROUTER` - true|false, default: false\n- `9ROUTER_BASE_URL` - 9Router base URL\n- `9ROUTER_API_KEY` - 9Router API key\n\n---\n\n## ๐ License\nMIT ยฉ 2026 Flux Flow.\n\n---\n*Forged with โก and ๐งฌ. Welcome to the FluxFlow.*\n","readmeFilename":"README.md"}
![\"FluxFlow](\"https://img.shields.io/badge/FluxFlow-v4-blue?style=plastic\"){kind=icon}
\n ![\"License](\"https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic\"){kind=icon}
\n ![\"Node](\"https://img.shields.io/badge/Node-%3E%3D22-green?style=plastic\"){kind=icon}
\n