🌌 Flux Flow (fluxflow-cli)

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.

🚀 Instant Ignition (No Setup Required)

You don't even need to install it. Just fire up your terminal and run:

# Run instantly (Zero Setup)
npx fluxflow-cli

# OR Install Globally
npm install -g fluxflow-cli
fluxflow-cli

The agent will prompt you for your Gemini API Key on the first run and store it securely in an XOR-encrypted vault. Free API Key recomemded to use Gemma 4 (Default Model).

✨ Why Flux Flow?

🎨 Premium Visual Sovereignty

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.

👁️ 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.

📑 Autonomous PDF Generator

Need a report? Just ask. Flux Flow uses its internal "Printing Press" to generate professional, branded PDF documents from HTML/CSS, complete with consistent margins and a signature watermark.

🚑 Self-Healing Infrastructure

Zero 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.

• Archived Terminal Flow: See execution outputs transform from live elements into permanent conversation records.
• Rich Aesthetics: High-contrast, sleek design with smooth transitions and micro-animations.

🧠 The Dual-Intelligence System

• Flux Mode (Dev): High-speed, agentic problem solving with a 50-turn persistent loop for massive coding tasks.
• Flow Mode (Chat): Optimized for deep research, high-quality conversation, and web-assisted reasoning.

🛡️ Digital Fortress Governance

Security isn't an afterthought; it's a boundary.

• External Path Hardlock: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
• Human-in-the-Loop (HITL): Every file write and terminal command requires your high-fidelity approval.
• XOR Vaulting: All local session histories, memories, and API keys are obfuscated and encrypted at rest.
• Adaptive Failover: Automatic multi-stage retry logic with high-concurrency fallback model switching (Gemini 3.1 Flash Lite) during peak API congestion.

🧹 The Background Janitor

While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.

🛠️ Key Capabilities

• Deep File-System Interaction: Edit, move, and refactor code across multiple files with atomic precision.
• Real-Time Web Intelligence: Autonomous web-searching via DuckDuckGo for live news and technical research.
• 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.
• High-Reliability Fallback: Automatic failover to a lighter, high-concurrency model during peak traffic to ensure zero session loss.
• Persistent Memory: The agent learns from your preferences and project requirements across sessions.

⚙️ Configuration

Type /settings in-app to live-configure:

• Thinking Level: Low, Medium, or High (Deep-Reasoning).
• Auto-Execution: For ultimate high-speed flow (Advanced users only).
• Security Perimeter: Toggle External Workspace access.

🏁 License

MIT © 2026 Flux Flow Team.

Forged with ⚡ and 🧬. Welcome to the FluxFlow.