fluxflow-cli 1.1.6 โ†’ 1.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +47 -56
  2. package/dist/fluxflow.js +2 -2
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,35 +1,14 @@
1
- # ๐ŸŒŠ Flux Flow
2
- ![Flux Flow Hero](./fluxflow.png)
1
+ # ๐ŸŒŒ Flux Flow (`fluxflow-cli`)
2
+ ![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
3
3
 
4
- **A Beautiful, Autonomous Terminal AI Agent**
4
+ ### *The High-Fidelity Agentic Terminal for the Flux Era.*
5
5
 
6
- Flux Flow is an advanced, fully autonomous AI agent that lives directly in your terminal. Built with Node.js and [Ink](https://github.com/vadimdemedes/ink) (React for interactive command-line apps), it provides a highly responsive, component-based UI powered by a sophisticated dual-model AI architecture.
7
-
8
- Whether you need a conversational partner or an autonomous developer that can write code, run shell commands, and read your project files, Flux Flow adapts to your needs.
6
+ **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.
9
7
 
10
8
  ---
11
9
 
12
- ## โœจ Features
13
-
14
- - **Responsive Terminal UI**: A gorgeous, reactive interface built with React and Ink, featuring multi-line input, status bars, modals, and diff views.
15
- - **Dual-Model Architecture**: A primary agent interacts with you and executes tasks, while a silent background "Janitor" model handles chat summarization and long-term memory extraction without blocking the main UI.
16
- - **Two Operating Modes**:
17
- - **Flux (Dev Mode)**: Full system access. The agent can read/write files, execute shell commands, and run autonomous agentic loops (up to 45 iterations) to solve complex coding tasks.
18
- - **Flow (Chat Mode)**: Focused on conversation and web research, with limited agentic loops for faster response times.
19
- - **Advanced Memory System**: Features both temporary session context and persistent, cross-session user memories encrypted locally on your machine.
20
- - **Agentic Tooling**: Built-in tools for smart file patching, web scraping, web searching, and terminal execution.
21
- - **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity coding standards and complex workflows.
22
- - **Customizable "Thinking" Levels**: Adjust the depth of the model's reasoning process (from Minimal to Max).
23
- - **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model (Gemini 3.1 Flash Lite) during peak traffic to ensure 100% session persistence.
24
-
25
- ## ๐Ÿš€ Quick Start
26
-
27
- ### Prerequisites
28
- - [Node.js](https://nodejs.org/) (v18 or higher recommended)
29
- - `npm`, `yarn`, or `pnpm`
30
-
31
- ### Via NPM (Global & Instant)
32
- You can run the agent instantly or install it globally for high-speed access:
10
+ ## ๐Ÿš€ Instant Ignition (No Setup Required)
11
+ You don't even need to install it. Just fire up your terminal and run:
33
12
 
34
13
  ```bash
35
14
  # Run instantly (Zero Setup)
@@ -37,44 +16,56 @@ npx fluxflow-cli
37
16
 
38
17
  # OR Install Globally
39
18
  npm install -g fluxflow-cli
40
- fluxflow
19
+ fluxflow-cli
41
20
  ```
42
21
 
43
- ### From Source (Local Development)
44
- 1. Clone the repository and install dependencies:
45
- ```bash
46
- git clone <repository-url>
47
- cd Flux-Flow
48
- npm install
49
- ```
22
+ *The agent will prompt you for your Gemini API Key on the first run and store it securely in an XOR-encrypted vault.*
50
23
 
51
- 2. Start the agent:
52
- ```bash
53
- npm start
54
- ```
24
+ ---
55
25
 
56
- ## ๐Ÿ“– Documentation
26
+ ## โœจ Why Flux Flow?
57
27
 
58
- To keep this README concise, detailed information about specific components of Flux Flow has been split into separate documents:
28
+ ### ๐ŸŽจ **Premium Visual Sovereignty**
29
+ Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
30
+ - **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
31
+ - **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
32
+ - **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
59
33
 
60
- - **[Architecture & Design](./ARCHITECTURE.md)**: Deep dive into the React/Ink rendering, the Agentic Loop, and the Janitor background process.
61
- - **[Agent Tools & Capabilities](./TOOLS.md)**: A comprehensive list of the tools available to the agent (e.g., File I/O, Execution, Web tools).
62
- - **[UI & Interaction Features](./UI_FEATURES.md)**: Details on commands, thinking levels, and human-in-the-loop verification.
34
+ ### ๐Ÿง  **The Dual-Intelligence System**
35
+ - **Flux Mode (Dev)**: High-speed, agentic problem solving with a 50-turn persistent loop for massive coding tasks.
36
+ - **Flow Mode (Chat)**: Optimized for deep research, high-quality conversation, and web-assisted reasoning.
63
37
 
64
- ## ๐Ÿ”’ Security & Privacy
38
+ ### ๐Ÿ›ก๏ธ **Digital Fortress Governance**
39
+ Security isn't an afterthought; it's a boundary.
40
+ - **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
41
+ - **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
42
+ - **XOR Vaulting**: All local session histories, memories, and API keys are obfuscated and encrypted at rest.
43
+ - **Adaptive Failover**: Automatic multi-stage retry logic with high-concurrency fallback model switching (Gemini 3.1 Flash Lite) during peak API congestion.
65
44
 
66
- Flux Flow runs entirely locally on your machine.
67
- - **Global Storage**: All history, memories, and API keys are stored securely in your home directory at `~/.fluxflow`. Sensitive data is encrypted.
68
- - **Nuclear Reset**: Use the `/reset` command to instantly purge all logs, secrets, and settings from the global storage directory.
69
- - **Configurable Boundaries**: In Flux mode, file access can be strictly confined to the Current Working Directory, or expanded globally via settings.
70
- - **API Keys**: You supply your own Gemini/Google AI Studio API keys.
45
+ ### ๐Ÿงน **The Background Janitor**
46
+ 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.
71
47
 
72
- ## ๐Ÿ› ๏ธ Built With
48
+ ---
49
+
50
+ ## ๐Ÿ› ๏ธ Key Capabilities
51
+ - **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
52
+ - **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
53
+ - **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.
54
+ - **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model during peak traffic to ensure zero session loss.
55
+ - **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
56
+
57
+ ---
58
+
59
+ ## โš™๏ธ Configuration
60
+ Type `/settings` in-app to live-configure:
61
+ - **Thinking Level**: Low, Medium, or High (Deep-Reasoning).
62
+ - **Auto-Execution**: For ultimate high-speed flow (Advanced users only).
63
+ - **Security Perimeter**: Toggle External Workspace access.
64
+
65
+ ---
73
66
 
74
- - **[React](https://react.dev/) & [Ink](https://github.com/vadimdemedes/ink)**: For the interactive CLI rendering.
75
- - **[@google/genai](https://www.npmjs.com/package/@google/genai)**: The core AI SDK powering the agent's intelligence.
76
- - **[chalk](https://www.npmjs.com/package/chalk) & [gradient-string](https://www.npmjs.com/package/gradient-string)**: For terminal styling and aesthetics.
77
- - **[fs-extra](https://www.npmjs.com/package/fs-extra)**: For robust file system operations.
67
+ ## ๐Ÿ License
68
+ MIT ยฉ 2026 Flux Flow Team.
78
69
 
79
70
  ---
80
- *Created as a demonstration of highly capable AI tooling.*
71
+ *Forged with โšก and ๐Ÿงฌ. Welcome to the FluxFlow.*
package/dist/fluxflow.js CHANGED
@@ -486,7 +486,7 @@ ${userMemories}
486
486
  ` : ""}${isMemoryEnabled ? `${tempMemoriesStr}
487
487
 
488
488
  ` : ""}--- START SYSTEM INSTRUCTION ---
489
- You are Flux Flow. A CLI Agent. Your tone will be friendly, warm, sassy, approchable, funny, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes unless explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And try to minimize number of agentic loops (Agent Loop is limited to 50 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 7 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
489
+ You are Flux Flow (made by Kushal Roy Chowdhury/Flux Flow Team). A CLI Agent. Your tone will be friendly, warm, sassy, approchable, funny, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes unless explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And try to minimize number of agentic loops (Agent Loop is limited to 50 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 7 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
490
490
  CURRENT_WORKING_DIRECTORY: ${cwdStr}.
491
491
  OS: ${osDetected}. ${osDetected && mode == "Flux" ? "Your terminal commands will run on CMD. Prefer PS scripts via CMD instead of raw CMD commands." : ""}
492
492
  ${nameStr}${nicknameStr}${userInstrStr}
@@ -1861,7 +1861,7 @@ var emojiSpace = (baseSpaces = 2) => {
1861
1861
  // src/app.jsx
1862
1862
  var SESSION_START_TIME = Date.now();
1863
1863
  var CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
1864
- var versionFluxflow = "1.1.6";
1864
+ var versionFluxflow = "1.1.8";
1865
1865
  var updatedOn = "2026-04-27";
1866
1866
  var ResolutionModal = ({ data, onResolve, onEdit }) => /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 2, paddingY: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Text9, { color: "magenta", bold: true, underline: true }, "\u{1F7E3} STEERING HINT RESOLUTION"), /* @__PURE__ */ React9.createElement(Text9, { marginTop: 1 }, "The agent already finished the task (turn: finish) before your hint was consumed."), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1, backgroundColor: "#222", paddingX: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Text9, { italic: true, color: "gray" }, '"', data, '"')), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1 }, /* @__PURE__ */ React9.createElement(Text9, { color: "cyan" }, "How would you like to proceed?")), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1 }, /* @__PURE__ */ React9.createElement(
1867
1867
  CommandMenu,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fluxflow-cli",
3
- "version": "1.1.6",
3
+ "version": "1.1.8",
4
4
  "description": "A high-fidelity agentic terminal assistant for the Flux Era.",
5
5
  "keywords": [
6
6
  "ai",