fluxflow-cli 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kushal Roy Chowdhury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/TOOLS.md

@@ -0,0 +1,48 @@
+# 🧰 Agent Tools & Capabilities
+
+Flux Flow provides a robust set of tools that allow the AI to interact with the file system, execute code, and search the web. The availability of these tools depends on the active operating mode.
+
+## Tool Availability by Mode
+
+| Tool | Flux Mode (Dev) | Flow Mode (Chat) |
+| :--- | :---: | :---: |
+| **Web Search** | ✅ | ✅ |
+| **Web Scrape** | ✅ | ✅ |
+| **View/Read Files** | ✅ | ❌ |
+| **Write/Update Files** | ✅ | ❌ |
+| **Execute Commands** | ✅ | ❌ |
+
+---
+
+## Core Tools
+
+### 🌐 Web & Research
+- **`web_search`**: Uses DuckDuckGo to find up-to-date information on the internet. Crucial for answering questions about recent events or unlearned documentation.
+- **`web_scrape`**: Extracts the detailed text content from a specific URL, allowing the agent to read documentation or articles.
+
+### 📁 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.
+- **`view_file`**: Reads the content of a file. Supports reading specific line ranges (`start_line`, `end_line`) to manage context size efficiently.
+
+### ✍️ Code Editing
+- **`write_file`**: Creates a new file or completely overwrites an existing one with new content.
+- **`update_file` (Smart Patching)**: Surgically replaces a specific block of text within a file. 
+  - *Diff Generation*: It returns a high-fidelity visual diff (Red/Green changes with context lines) to the UI, allowing the user to see exactly what the agent modified.
+
+### 💻 Terminal Execution
+- **`exec_command`**: Runs a shell command directly in the terminal using Node's `child_process.spawn`. 
+  - *Context Aware*: Runs in the current working directory.
+  - *Cross-Platform*: Uses `shell: true` to handle Windows `.cmd`/`.bat` files natively.
+
+---
+
+## Memory Management
+
+The memory tool (`memory.js`) is primarily used by the background **Janitor** model, but can be accessed by the main agent if necessary.
+
+- **Temporary Context (`action='temp'`)**: Saves a rolling summary of the current session to maintain conversational context without bloating the main prompt history.
+- **Persistent User Memory (`action='user'`)**: 
+  - The Janitor analyzes conversations to detect user preferences, hobbies, or instructions.
+  - It uses `add`, `update`, or `delete` methods to manage facts in the encrypted `memories.json` vault.
+  - These memories are injected into the system prompt of *future* sessions, allowing Flux Flow to learn and adapt to the user over time.

package/UI_FEATURES.md

@@ -0,0 +1,66 @@
+# 🎮 User Interface & Interaction Features
+
+Flux Flow is designed to be a high-performance terminal application. Beyond basic chat, it includes a variety of advanced UI features and human-in-the-loop controls to keep you in command of the agent.
+
+## ⌨️ Command System
+
+You can control the application using `/` commands directly in the chat input:
+
+- **/mode [flux|flow]**: Quickly switch between **Flux** (Dev) and **Flow** (Chat) modes. Using it without arguments opens the selection menu.
+- **/thinking [low|medium|high|max|show|hide]**: Adjust reasoning depth or toggle visibility of the thinking process. Using it without arguments opens the selection menu.
+- **/model [name]**: Choose which AI model to use for the main interaction.
+- **/key**: Open the API Key management view to update or remove your credentials.
+- **/settings**: Access the system configuration menu.
+- **/profile**: Update your name, nickname, and custom instructions.
+- **/memory**: View and manage the persistent memories extracted by the Janitor.
+- **/resume <chat-id>**: Switch back to a previous conversation.
+- **/help**: List all available commands.
+
+### Command Shortcuts
+
+For power users, several commands support direct arguments to skip the menus:
+- ` /mode flux ` or ` /mode flow `
+- ` /thinking low ` / ` /thinking medium ` / ` /thinking high ` / ` /thinking max `
+- ` /thinking show ` / ` /thinking hide ` (Toggles thinking process visibility)
+- ` /model gemini-3.1-pro-preview ` (Switches model directly)
+
+## 🧠 Thinking Levels & Visualization
+
+Flux Flow separates the model's "internal monologue" (reasoning) from its final response using `<think>` tags.
+
+- **Thinking Levels**: Depending on the mode, you can choose from **Low**, **Medium**, **High**, or **Max**. Higher levels allow the agent more "space" to reason through complex architecture or debugging problems.
+- **Show/Hide Thinking**: You can toggle the visibility of the thinking process using `/thinking show/hide`. 
+  - When **Hidden**, the agent doesn't just disappear; it provides a "minimalist" view showing only the core **Headings** and **Action Steps** (bolded lines) from its reasoning. This keeps you informed of its current "step" without cluttering the screen with detailed internal monologue.
+
+## 🛡️ Human-in-the-Loop (HITL) Verification
+
+Security and safety are paramount when an AI has access to your file system and terminal. Flux Flow implements several layers of verification:
+
+### Tool Approval
+By default, the agent **cannot** execute dangerous actions without your consent.
+- **Terminal Approval**: If the agent attempts to run a shell command (`exec_command`), a dedicated approval screen appears showing the exact command. You can **Allow** or **Deny** the execution.
+- **File Approval**: Similar to terminal commands, writing or updating files requires manual approval unless configured otherwise.
+- **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`. 
+- **⚠️ 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.
+
+## 🔄 Steering & Resolution
+
+### Real-time Steering
+If you realize the agent is going down the wrong path *while* it is in an agentic loop, you can provide "Steering Hints." The system will inject your feedback into the next loop to course-correct the agent.
+
+### Resolution Modal
+If the agent finishes its task just as you send a steering hint, a **Resolution Modal** appears. It asks if you want to:
+- **Send Anyway**: Start a new loop with your feedback.
+- **Edit Prompt**: Refine your feedback before sending.
+
+## 📊 Status Bar & Feedback
+The bottom of the screen features a dynamic status bar showing:
+- **Active Mode** (Flux/Flow)
+- **Thinking Level**
+- **Token Usage**: Real-time tracking of tokens used in the current session.
+- **Agentic Loops**: Counters showing how many times the agent has "looped" to solve the current task.
+- **API Status**: Visual feedback when the model is thinking or executing a tool.

package/dist/{index.js → fluxflow.js}

@@ -8,8 +8,6 @@ import { render } from "ink";
 import React8, { useState as useState4, useEffect as useEffect3, useRef, useMemo } from "react";
 import { Box as Box8, Text as Text8, useInput as useInput3, useStdout, Static } from "ink";
 import fs14 from "fs-extra";
-import path16 from "path";
-import { fileURLToPath as fileURLToPath9 } from "url";
 import { MultilineInput } from "ink-multiline-input";
 import TextInput2 from "ink-text-input";
 
@@ -194,7 +192,7 @@ function StatusBar({ mode, thinkingLevel, tokens = "0.0k", chatId = "NEW-SESSION
     },
     /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: modeColor, bold: true }, modeIcon, " ", mode.toUpperCase()), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "magenta" }, "\u{1F9E0} ", thinkingLevel)),
     /* @__PURE__ */ React3.createElement(Box3, { flexGrow: 1, justifyContent: "center", paddingX: 2 }, /* @__PURE__ */ React3.createElement(Text3, { color: "gray", dimColor: true }, "\u{1F4C1} "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue", dimColor: true, italic: true }, process.cwd())),
-    /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, "MEM: "), /* @__PURE__ */ React3.createElement(Text3, { color: memStatus === "ON" ? "green" : "red" }, memStatus), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue" }, " Tokens ", tokens > 1e3 ? `${(tokens / 1e3).toFixed(1)}k` : tokens, " (", Math.round(tokens / 128e3 * 100), "%)"), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "dim" }, "ID: ", chatId, " "))
+    /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, "MEM: "), /* @__PURE__ */ React3.createElement(Text3, { color: memStatus === "ON" ? "green" : "red" }, memStatus), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue" }, " Tokens ", tokens > 1e3 ? `${(tokens / 1e3).toFixed(1)}k` : tokens, " (", Math.round(tokens / 196e3 * 100), "%)"), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "dim" }, "ID: ", chatId, " "))
   );
 }
 
@@ -257,8 +255,6 @@ import gradient from "gradient-string";
 
 // src/utils/secrets.js
 import fs2 from "fs-extra";
-import path2 from "path";
-import { fileURLToPath } from "url";
 
 // src/utils/crypto.js
 import fs from "fs";
@@ -295,12 +291,21 @@ var writeEncryptedJson = (filePath, data) => {
   }
 };
 
+// src/utils/paths.js
+import os from "os";
+import path2 from "path";
+var FLUXFLOW_DIR = path2.join(os.homedir(), ".fluxflow");
+var LOGS_DIR = path2.join(FLUXFLOW_DIR, "logs");
+var SECRET_DIR = path2.join(FLUXFLOW_DIR, "secret");
+var SETTINGS_FILE = path2.join(FLUXFLOW_DIR, "settings.json");
+var HISTORY_FILE = path2.join(SECRET_DIR, "history.json");
+var USAGE_FILE = path2.join(SECRET_DIR, "usage.json");
+var MEMORIES_FILE = path2.join(SECRET_DIR, "memories.json");
+var TEMP_MEM_FILE = path2.join(SECRET_DIR, "memory-temp.json");
+
 // src/utils/secrets.js
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path2.dirname(__filename);
-var AGENT_ROOT = path2.join(__dirname, "../../");
-var SECRET_DIR = path2.join(AGENT_ROOT, "secret");
-var SECRET_FILE = path2.join(SECRET_DIR, "secrets.json");
+import path3 from "path";
+var SECRET_FILE = path3.join(SECRET_DIR, "secrets.json");
 var getAPIKey = async () => {
   try {
     const secrets = readEncryptedJson(SECRET_FILE, {});
@@ -476,13 +481,8 @@ Current date and Time: ${(/* @__PURE__ */ new Date()).toLocaleString()}
 
 // src/utils/history.js
 import fs3 from "fs-extra";
-import path3 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import path4 from "path";
 import { nanoid } from "nanoid";
-var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = path3.dirname(__filename2);
-var AGENT_ROOT2 = path3.join(__dirname2, "../../");
-var HISTORY_FILE = path3.join(AGENT_ROOT2, "secret/history.json");
 var WRITE_LOCK = Promise.resolve();
 var withLock = (op) => {
   const nextLock = WRITE_LOCK.then(async () => {
@@ -517,7 +517,7 @@ var saveChat = async (id, name, messages) => {
       messages,
       updatedAt: Date.now()
     };
-    await fs3.ensureDir(path3.dirname(HISTORY_FILE));
+    await fs3.ensureDir(path4.dirname(HISTORY_FILE));
     await fs3.writeJson(HISTORY_FILE, history, { spaces: 2 });
   });
 };
@@ -530,7 +530,7 @@ var saveChatTitle = async (id, title) => {
     } else {
       history[id] = { name: title, messages: [], updatedAt: Date.now() };
     }
-    await fs3.ensureDir(path3.dirname(HISTORY_FILE));
+    await fs3.ensureDir(path4.dirname(HISTORY_FILE));
     await fs3.writeJson(HISTORY_FILE, history, { spaces: 2 });
   });
 };
@@ -539,13 +539,12 @@ var deleteChat = async (id) => {
     const history = await loadHistory();
     delete history[id];
     await fs3.writeJson(HISTORY_FILE, history, { spaces: 2 });
-    const tempFile = path3.join(AGENT_ROOT2, "secret/memory-temp.json");
-    if (await fs3.pathExists(tempFile)) {
+    if (await fs3.pathExists(TEMP_MEM_FILE)) {
       try {
-        const temp = await fs3.readJson(tempFile);
+        const temp = await fs3.readJson(TEMP_MEM_FILE);
         if (temp[id]) {
           delete temp[id];
-          await fs3.writeJson(tempFile, temp, { spaces: 2 });
+          await fs3.writeJson(TEMP_MEM_FILE, temp, { spaces: 2 });
         }
       } catch (e) {
       }
@@ -582,15 +581,11 @@ var getTruncatedHistory = (history, exchangesToRemove = 4) => {
 
 // src/utils/usage.js
 import fs4 from "fs-extra";
-import path4 from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var __dirname3 = path4.dirname(fileURLToPath3(import.meta.url));
-var USAGE_PATH = path4.join(__dirname3, "../../secret/usage.json");
 var getDailyUsage = async () => {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   try {
-    if (await fs4.exists(USAGE_PATH)) {
-      const data = await fs4.readJson(USAGE_PATH);
+    if (await fs4.exists(USAGE_FILE)) {
+      const data = await fs4.readJson(USAGE_FILE);
       if (data.date === today) {
         return data.stats;
       }
@@ -599,19 +594,19 @@ var getDailyUsage = async () => {
     console.error("Failed to read usage:", err);
   }
   const defaultStats = { agent: 0, background: 0, search: 0 };
-  await fs4.writeJson(USAGE_PATH, { date: today, stats: defaultStats }, { spaces: 2 });
+  await fs4.writeJson(USAGE_FILE, { date: today, stats: defaultStats }, { spaces: 2 });
   return defaultStats;
 };
 var incrementUsage = async (key) => {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const data = await fs4.readJson(USAGE_PATH).catch(() => ({ date: today, stats: { agent: 0, background: 0, search: 0 } }));
+  const data = await fs4.readJson(USAGE_FILE).catch(() => ({ date: today, stats: { agent: 0, background: 0, search: 0 } }));
   if (data.date !== today) {
     data.date = today;
     data.stats = { agent: 0, background: 0, search: 0 };
   }
   if (data.stats[key] !== void 0) {
     data.stats[key]++;
-    await fs4.writeJson(USAGE_PATH, data, { spaces: 2 });
+    await fs4.writeJson(USAGE_FILE, data, { spaces: 2 });
   }
 };
 var checkQuota = async (key, settings) => {
@@ -662,10 +657,6 @@ var parseArgs = (argsString) => {
 // src/tools/web_search.js
 import fs5 from "fs";
 import path5 from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
-var __filename3 = fileURLToPath4(import.meta.url);
-var __dirname4 = path5.dirname(__filename3);
-var AGENT_ROOT3 = path5.join(__dirname4, "../../");
 var web_search = async (argsString) => {
   const { query, limit = 10 } = parseArgs(argsString);
   if (!query) return 'ERROR: Missing "query" argument for web_search.';
@@ -693,7 +684,7 @@ Source: ${url}
 Snippet: ${snippet}`);
       count++;
     }
-    const toolLogDir = path5.join(AGENT_ROOT3, "logs", "tools");
+    const toolLogDir = path5.join(LOGS_DIR, "tools");
     if (!fs5.existsSync(toolLogDir)) {
       fs5.mkdirSync(toolLogDir, { recursive: true });
     }
@@ -705,7 +696,7 @@ Results: ${results}
 `);
     if (results.length === 0) {
       if (html.includes("anomaly")) {
-        const toolErrDir = path5.join(AGENT_ROOT3, "logs", "tools");
+        const toolErrDir = path5.join(LOGS_DIR, "tools");
         if (!fs5.existsSync(toolErrDir)) {
           fs5.mkdirSync(toolErrDir, { recursive: true });
         }
@@ -727,11 +718,7 @@ ${finalResults}`;
 // src/tools/web_scrape.js
 import fs6 from "fs";
 import path6 from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
 import * as cuimp2 from "cuimp";
-var __filename4 = fileURLToPath5(import.meta.url);
-var __dirname5 = path6.dirname(__filename4);
-var AGENT_ROOT4 = path6.join(__dirname5, "../../");
 var web_scrape = async (args) => {
   const urlMatch = args.match(/url\s*=\s*["'](.*)["']/);
   const url = urlMatch ? urlMatch[1] : args;
@@ -752,7 +739,7 @@ var web_scrape = async (args) => {
     html = html.replace(/<header\b[^<]*(?:(?!<\/header>)<[^<]*)*<\/header>/gi, "");
     let text = html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
     const finalContent = text.substring(0, 2e4);
-    const toolLogDir = path6.join(AGENT_ROOT4, "logs", "tools");
+    const toolLogDir = path6.join(LOGS_DIR, "tools");
     if (!fs6.existsSync(toolLogDir)) {
       fs6.mkdirSync(toolLogDir, { recursive: true });
     }
@@ -771,14 +758,6 @@ ${finalContent}${text.length > 2e4 ? "\n\n[TRUNCATED AT 20K CHARS]" : ""}`;
 };
 
 // src/tools/memory.js
-import path7 from "path";
-import { fileURLToPath as fileURLToPath6 } from "url";
-var __filename5 = fileURLToPath6(import.meta.url);
-var __dirname6 = path7.dirname(__filename5);
-var AGENT_ROOT5 = path7.join(__dirname6, "../../");
-var SECRET_DIR2 = path7.join(AGENT_ROOT5, "secret");
-var MEMORIES_PATH = path7.join(SECRET_DIR2, "memories.json");
-var TEMP_MEM_PATH = path7.join(SECRET_DIR2, "memory-temp.json");
 var memory = async (rawArgs, context = {}) => {
   const parseArg = (key) => {
     const regex = new RegExp(`${key}\\s*=\\s*(["'])(.*?)\\1(?=\\s*[,)]|\\s+\\w+\\s*=|$)`, "s");
@@ -793,23 +772,23 @@ var memory = async (rawArgs, context = {}) => {
   const chatId = parseArg("chat-id") || context.chatId || context.sessionId || "default-session";
   if (action === "temp") {
     if (!content) return "ERROR: Missing 'content' for temp memory.";
-    const tempStorage = readEncryptedJson(TEMP_MEM_PATH, {});
+    const tempStorage = readEncryptedJson(TEMP_MEM_FILE, {});
     if (!tempStorage[chatId]) tempStorage[chatId] = [];
-    const MAX_CHARS = 4e3 * 4;
+    const MAX_CHARS = 3e3 * 4;
     let currentTotalLength = tempStorage[chatId].reduce((acc, m) => acc + m.length, 0);
     while (tempStorage[chatId].length > 0 && currentTotalLength + content.length > MAX_CHARS) {
       const removed = tempStorage[chatId].shift();
       currentTotalLength -= removed.length;
     }
     tempStorage[chatId].push(content);
-    writeEncryptedJson(TEMP_MEM_PATH, tempStorage);
+    writeEncryptedJson(TEMP_MEM_FILE, tempStorage);
     return `SUCCESS: Temporary context saved for session [${chatId}]. (Size: ${currentTotalLength + content.length} chars)`;
   }
   if (action === "user") {
-    const memories = readEncryptedJson(MEMORIES_PATH, []);
+    const memories = readEncryptedJson(MEMORIES_FILE, []);
     if (method === "add") {
       if (!content) return "ERROR: Missing 'content' for memory addition.";
-      const MAX_CHARS = 3e3 * 4;
+      const MAX_CHARS = 2e3 * 4;
       let currentTotalLength = memories.reduce((acc, m) => acc + (m.memory?.length || 0), 0);
       while (memories.length > 0 && currentTotalLength + content.length > MAX_CHARS) {
         const removed = memories.shift();
@@ -817,7 +796,7 @@ var memory = async (rawArgs, context = {}) => {
       }
       const newMemory = { id: `mem-${Date.now().toString(36)}`, memory: content };
       memories.push(newMemory);
-      writeEncryptedJson(MEMORIES_PATH, memories);
+      writeEncryptedJson(MEMORIES_FILE, memories);
       return `SUCCESS: Memory added with ID [${newMemory.id}]. (Vault Size: ${currentTotalLength + content.length} chars)`;
     }
     if (method === "update") {
@@ -827,7 +806,7 @@ var memory = async (rawArgs, context = {}) => {
       const index = memories.findIndex((m) => m.id === memId);
       if (index === -1) return `ERROR: Memory ID [${memId}] not found.`;
       memories[index].memory = newText;
-      writeEncryptedJson(MEMORIES_PATH, memories);
+      writeEncryptedJson(MEMORIES_FILE, memories);
       return `SUCCESS: Memory [${memId}] updated.`;
     }
     if (method === "delete") {
@@ -836,7 +815,7 @@ var memory = async (rawArgs, context = {}) => {
       const initialLen = memories.length;
       const updatedMemories = memories.filter((m) => m.id !== memId);
       if (updatedMemories.length === initialLen) return `ERROR: Memory ID [${memId}] not found.`;
-      writeEncryptedJson(MEMORIES_PATH, updatedMemories);
+      writeEncryptedJson(MEMORIES_FILE, updatedMemories);
       return `SUCCESS: Memory [${memId}] deleted.`;
     }
     return `ERROR: Invalid method [${method}] for user memory. Use 'add', 'update', or 'delete'.`;
@@ -900,10 +879,10 @@ var summary = async (rawArgs, context = {}) => {
 
 // src/tools/list_files.js
 import fs7 from "fs";
-import path8 from "path";
+import path7 from "path";
 var list_files = async (args) => {
   const { path: targetPath = "." } = parseArgs(args);
-  const absolutePath = path8.resolve(process.cwd(), targetPath);
+  const absolutePath = path7.resolve(process.cwd(), targetPath);
   try {
     if (!fs7.existsSync(absolutePath)) {
       return `ERROR: Path [${targetPath}] does not exist.`;
@@ -920,7 +899,7 @@ var list_files = async (args) => {
     const maxDisplay = 100;
     const displayFiles = files2.slice(0, maxDisplay);
     const list = displayFiles.map((file) => {
-      const fPath = path8.join(absolutePath, file);
+      const fPath = path7.join(absolutePath, file);
       let indicator = "\u{1F4C4}";
       let metaPart = "";
       try {
@@ -955,11 +934,11 @@ ${list}${footer}`;
 
 // src/tools/view_file.js
 import fs8 from "fs";
-import path9 from "path";
+import path8 from "path";
 var view_file = async (args) => {
   const { path: targetPath, start_line = 1, end_line = 500 } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for view_file.';
-  const absolutePath = path9.resolve(process.cwd(), targetPath);
+  const absolutePath = path8.resolve(process.cwd(), targetPath);
   try {
     if (!fs8.existsSync(absolutePath)) {
       return `ERROR: File [${targetPath}] does not exist.`;
@@ -986,14 +965,14 @@ ${code}`;
 
 // src/tools/write_file.js
 import fs9 from "fs";
-import path10 from "path";
+import path9 from "path";
 var write_file = async (args) => {
   let { path: targetPath, content } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for write_file.';
   if (content === void 0) return 'ERROR: Missing "content" argument for write_file.';
   content = content.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
-  const absolutePath = path10.resolve(process.cwd(), targetPath);
-  const parentDir = path10.dirname(absolutePath);
+  const absolutePath = path9.resolve(process.cwd(), targetPath);
+  const parentDir = path9.dirname(absolutePath);
   try {
     if (!fs9.existsSync(parentDir)) {
       fs9.mkdirSync(parentDir, { recursive: true });
@@ -1034,7 +1013,7 @@ ${snippet}`;
 
 // src/tools/update_file.js
 import fs10 from "fs";
-import path11 from "path";
+import path10 from "path";
 var update_file = async (args) => {
   let { path: targetPath, content_to_replace, content_to_add } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for update_file.';
@@ -1043,7 +1022,7 @@ var update_file = async (args) => {
   const strip = (t) => t.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
   content_to_replace = strip(content_to_replace);
   content_to_add = strip(content_to_add);
-  const absolutePath = path11.resolve(process.cwd(), targetPath);
+  const absolutePath = path10.resolve(process.cwd(), targetPath);
   try {
     if (!fs10.existsSync(absolutePath)) {
       return `ERROR: File [${targetPath}] does not exist. Use write_file instead.`;
@@ -1136,10 +1115,10 @@ ${finalOutput}`);
 
 // src/tools/read_folder.js
 import fs11 from "fs";
-import path12 from "path";
+import path11 from "path";
 var read_folder = async (args) => {
   const { path: targetPath = "." } = parseArgs(args);
-  const absolutePath = path12.resolve(process.cwd(), targetPath);
+  const absolutePath = path11.resolve(process.cwd(), targetPath);
   try {
     if (!fs11.existsSync(absolutePath)) {
       return `ERROR: Path [${targetPath}] does not exist.`;
@@ -1153,7 +1132,7 @@ var read_folder = async (args) => {
     const displayItems = files.slice(0, maxDisplay);
     const folderData = [];
     for (const file of displayItems) {
-      const fPath = path12.join(absolutePath, file);
+      const fPath = path11.join(absolutePath, file);
       let indicator = "\u{1F4C4}";
       let info = { name: file, type: "unknown", size: "N/A", mtime: "N/A" };
       try {
@@ -1223,15 +1202,9 @@ var dispatchTool = async (toolName, args, context = {}) => {
 };
 
 // src/utils/ai.js
-import { fileURLToPath as fileURLToPath7 } from "url";
-import path13 from "path";
+import path12 from "path";
 import fs12 from "fs";
-var __filename6 = fileURLToPath7(import.meta.url);
-var __dirname7 = path13.dirname(__filename6);
-var AGENT_ROOT6 = path13.join(__dirname7, "../../");
 var client = null;
-var TEMP_MEM_PATH2 = path13.join(AGENT_ROOT6, "secret", "memory-temp.json");
-var PERSISTENT_MEM_PATH = path13.join(AGENT_ROOT6, "secret", "memories.json");
 var TERMINATION_SIGNAL = false;
 var signalTermination = () => {
   TERMINATION_SIGNAL = true;
@@ -1285,12 +1258,12 @@ var getAIStream = async function* (modelName, history, settings, steeringCallbac
   const needTitle = isFirstPrompt || hasTitleSignal;
   const agentText = originalText.replace(/\[TITLE-UPDATE\]/g, "").trim();
   let modifiedHistory = [...history.slice(0, -1)];
-  if (systemSettings?.compression === 0 && (sessionStats?.tokens || 0) > 128e3) {
+  if (systemSettings?.compression === 0 && (sessionStats?.tokens || 0) > 196e3) {
     modifiedHistory = getTruncatedHistory(modifiedHistory, 4);
   }
-  const tempStorage = readEncryptedJson(TEMP_MEM_PATH2, {});
+  const tempStorage = readEncryptedJson(TEMP_MEM_FILE, {});
   const otherMemories = Object.entries(tempStorage).filter(([id]) => id !== chatId).flatMap(([_, mems]) => mems).map((mem) => `- ${mem}`).join("\n");
-  const persistentStorage = readEncryptedJson(PERSISTENT_MEM_PATH, []);
+  const persistentStorage = readEncryptedJson(MEMORIES_FILE, []);
   const mainUserMemories = persistentStorage.map((m) => `- ${m.memory}`).join("\n");
   const janitorUserMemories = persistentStorage.map((m) => `- [${m.id}]: ${m.memory}`).join("\n");
   const systemInstruction = getSystemInstruction(profile, thinkingLevel, mode, systemSettings, otherMemories, mainUserMemories, isMemoryEnabled);
@@ -1344,11 +1317,11 @@ USER_PROMPT: ${agentText}`.trim();
       } catch (err) {
         const errMsg = err.message || String(err);
         const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-        const agentErrDir = path13.join(AGENT_ROOT6, "logs", "agent");
+        const agentErrDir = path12.join(LOGS_DIR, "agent");
         if (!fs12.existsSync(agentErrDir)) {
           fs12.mkdirSync(agentErrDir, { recursive: true });
         }
-        fs12.appendFileSync(path13.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errMsg}
+        fs12.appendFileSync(path12.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errMsg}
 `);
         const isRetryable = errMsg.includes("429") || errMsg.includes("503") || errMsg.includes("overloaded") || errMsg.includes("deadline");
         if (isRetryable && retryCount < MAX_RETRIES) {
@@ -1394,7 +1367,17 @@ USER_PROMPT: ${agentText}`.trim();
           const url = parseArgs(toolCall.args).url || "...";
           label = `\u{1F4D6} READING SITE: ${url}`.toUpperCase();
         } else if (toolCall.toolName === "view_file") {
-          label = `\u{1F4C4} READING FILE: ${parseArgs(toolCall.args).path || "..."}`.toUpperCase();
+          const { path: targetPath2, start_line = 1, end_line = 500 } = parseArgs(toolCall.args);
+          let totalLines = "...";
+          try {
+            const absPath = path12.resolve(process.cwd(), targetPath2);
+            if (fs12.existsSync(absPath)) {
+              const content = fs12.readFileSync(absPath, "utf8");
+              totalLines = content.split("\n").length;
+            }
+          } catch (e) {
+          }
+          label = `\u{1F4C4} READING FILE: ${targetPath2}. LINES ${start_line} - ${end_line} FROM ${totalLines}`.toUpperCase();
         } else if (toolCall.toolName === "list_files" || toolCall.toolName === "read_folder") {
           const action = toolCall.toolName === "list_files" ? "LISTING" : "DISCOVERING";
           label = `\u{1F4C2} ${action} DIRECTORY: ${parseArgs(toolCall.args).path || "."}`.toUpperCase();
@@ -1435,7 +1418,7 @@ ${boxBottom}
               /\/usr\//
               // Sensitive Linux paths
             ];
-            const currentDrive = path13.resolve(process.cwd()).substring(0, 3).toLowerCase();
+            const currentDrive = path12.resolve(process.cwd()).substring(0, 3).toLowerCase();
             const isViolating = riskyPatterns.some((pattern) => {
               if (pattern.source === "[a-zA-Z]:[\\\\\\/]") {
                 const driveMatch = command.match(/[a-zA-Z]:[\\\/]/i);
@@ -1457,8 +1440,8 @@ ${boxBottom}
         const targetPath = parsedArgs.path || parsedArgs.targetPath || null;
         if (targetPath) {
           const isExternalOff = settings.systemSettings && settings.systemSettings.allowExternalAccess === false;
-          const absoluteTarget = path13.resolve(targetPath);
-          const absoluteCwd = path13.resolve(process.cwd());
+          const absoluteTarget = path12.resolve(targetPath);
+          const absoluteCwd = path12.resolve(process.cwd());
           if (isExternalOff && !absoluteTarget.startsWith(absoluteCwd)) {
             const denyMsg = `Access Denied. You are not allowed to access files outside the current workspace. To enable this, ask the user to turn on "External Workspace Access" in /settings.`;
             toolResults.push(`[TOOL_RESULT]: ERROR: ${denyMsg}`);
@@ -1497,11 +1480,11 @@ ${boxBottom}
           const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
           const isErr = result.startsWith("ERROR:");
           const logStatus = isErr ? result.trim() : "SUCCESS";
-          const toolHistDir = path13.join(AGENT_ROOT6, "logs", "tools");
+          const toolHistDir = path12.join(LOGS_DIR, "tools");
           if (!fs12.existsSync(toolHistDir)) {
             fs12.mkdirSync(toolHistDir, { recursive: true });
           }
-          fs12.appendFileSync(path13.join(toolHistDir, "history.log"), `HISTORY [${timestamp}]: ${toolCall.toolName} [${logStatus}]
+          fs12.appendFileSync(path12.join(toolHistDir, "history.log"), `HISTORY [${timestamp}]: ${toolCall.toolName} [${logStatus}]
 `);
         } catch (logErr) {
         }
@@ -1555,11 +1538,11 @@ ${boxBottom}
         if (parts && parts[1]?.text) {
           finalSynthesis = parts[1].text;
           const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-          const janitorLogDir = path13.join(AGENT_ROOT6, "logs", "janitor");
+          const janitorLogDir = path12.join(LOGS_DIR, "janitor");
           if (!fs12.existsSync(janitorLogDir)) {
             fs12.mkdirSync(janitorLogDir, { recursive: true });
           }
-          fs12.appendFileSync(path13.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: ${finalSynthesis}
+          fs12.appendFileSync(path12.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: ${finalSynthesis}
 `);
         } else if (parts && parts[0]?.text) finalSynthesis = parts[0].text;
         else if (janitorResult.response && janitorResult.response.text) finalSynthesis = janitorResult.response.text();
@@ -1571,8 +1554,8 @@ ${boxBottom}
           const toolContext = { chatId, sessionId: chatId, history };
           const result = await dispatchTool(janitorToolCall.toolName, janitorToolCall.args, toolContext);
           const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-          const janitorLogDir = path13.join(AGENT_ROOT6, "logs", "janitor");
-          fs12.appendFileSync(path13.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: RESULT [${janitorToolCall.toolName}]: ${result}
+          const janitorLogDir = path12.join(LOGS_DIR, "janitor");
+          fs12.appendFileSync(path12.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: RESULT [${janitorToolCall.toolName}]: ${result}
 `);
           if (janitorToolCall.toolName === "memory" && !janitorToolCall.args.includes("action='temp'")) {
             yield { type: "memory_updated" };
@@ -1580,11 +1563,11 @@ ${boxBottom}
         }
       } catch (janitorErr) {
         const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-        const janitorErrDir = path13.join(AGENT_ROOT6, "logs", "janitor");
+        const janitorErrDir = path12.join(LOGS_DIR, "janitor");
         if (!fs12.existsSync(janitorErrDir)) {
           fs12.mkdirSync(janitorErrDir, { recursive: true });
         }
-        fs12.appendFileSync(path13.join(janitorErrDir, "error.log"), `ERROR [${date}]: ${janitorErr.message}
+        fs12.appendFileSync(path12.join(janitorErrDir, "error.log"), `ERROR [${date}]: ${janitorErr.message}
 `);
         console.error("Janitor Background Tasks Failed:", janitorErr.message);
       }
@@ -1612,10 +1595,6 @@ ${timestamp}`;
 
 // src/utils/settings.js
 import fs13 from "fs-extra";
-import path14 from "path";
-import { fileURLToPath as fileURLToPath8 } from "url";
-var __dirname8 = path14.dirname(fileURLToPath8(import.meta.url));
-var SETTINGS_PATH = path14.join(__dirname8, "../../settings.json");
 var DEFAULT_SETTINGS = {
   mode: "Flux",
   thinkingLevel: "Medium",
@@ -1644,8 +1623,8 @@ var DEFAULT_SETTINGS = {
 };
 var loadSettings = async () => {
   try {
-    if (await fs13.exists(SETTINGS_PATH)) {
-      const saved = await fs13.readJson(SETTINGS_PATH);
+    if (await fs13.exists(SETTINGS_FILE)) {
+      const saved = await fs13.readJson(SETTINGS_FILE);
       return {
         ...DEFAULT_SETTINGS,
         ...saved,
@@ -1663,7 +1642,7 @@ var saveSettings = async (settings) => {
   try {
     const current = await loadSettings();
     const updated = { ...current, ...settings };
-    await fs13.writeJson(SETTINGS_PATH, updated, { spaces: 2 });
+    await fs13.writeJson(SETTINGS_FILE, updated, { spaces: 2 });
     return true;
   } catch (err) {
     console.error("Failed to save settings:", err);
@@ -1712,13 +1691,13 @@ function ResumeModal({ onSelect, onDelete, onClose }) {
 // src/components/MemoryModal.jsx
 import React7, { useState as useState3, useEffect as useEffect2 } from "react";
 import { Box as Box7, Text as Text7, useInput as useInput2 } from "ink";
-import path15 from "path";
-var MEMORIES_PATH2 = path15.join(process.cwd(), "secret", "memories.json");
+import path13 from "path";
+var MEMORIES_PATH = path13.join(process.cwd(), "secret", "memories.json");
 function MemoryModal({ onClose }) {
   const [memories, setMemories] = useState3([]);
   const [selectedIndex, setSelectedIndex] = useState3(0);
   const loadMemories = () => {
-    const data = readEncryptedJson(MEMORIES_PATH2, []);
+    const data = readEncryptedJson(MEMORIES_PATH, []);
     setMemories(data);
   };
   useEffect2(() => {
@@ -1731,7 +1710,7 @@ function MemoryModal({ onClose }) {
     if (input === "x" && memories.length > 0) {
       const idToDelete = memories[selectedIndex].id;
       const updated = memories.filter((m) => m.id !== idToDelete);
-      writeEncryptedJson(MEMORIES_PATH2, updated);
+      writeEncryptedJson(MEMORIES_PATH, updated);
       setMemories(updated);
       if (selectedIndex >= updated.length && updated.length > 0) {
         setSelectedIndex(updated.length - 1);
@@ -2086,18 +2065,19 @@ ${list || "No saved chats found."}` }];
         }
         case "/reset": {
           const runReset = async () => {
-            const AGENT_ROOT7 = path16.join(path16.dirname(fileURLToPath9(import.meta.url)), "../");
-            const logsDir = path16.join(AGENT_ROOT7, "logs");
-            const secretDir = path16.join(AGENT_ROOT7, "secret");
-            const settingsFile = path16.join(AGENT_ROOT7, "settings.json");
             try {
               setMessages((prev) => {
                 setCompletedIndex(prev.length + 1);
                 return [...prev, { id: Date.now(), role: "system", text: "\u2622\uFE0F [NUCLEAR] Initiating reset..." }];
               });
-              if (fs14.existsSync(logsDir)) fs14.removeSync(logsDir);
-              if (fs14.existsSync(secretDir)) fs14.removeSync(secretDir);
-              if (fs14.existsSync(settingsFile)) fs14.removeSync(settingsFile);
+              if (fs14.existsSync(LOGS_DIR)) fs14.removeSync(LOGS_DIR);
+              if (fs14.existsSync(SECRET_DIR)) fs14.removeSync(SECRET_DIR);
+              if (fs14.existsSync(SETTINGS_FILE)) fs14.removeSync(SETTINGS_FILE);
+              try {
+                const items = fs14.readdirSync(FLUXFLOW_DIR);
+                if (items.length === 0) fs14.removeSync(FLUXFLOW_DIR);
+              } catch (e) {
+              }
               setTimeout(() => {
                 setActiveView("exit");
                 setTimeout(() => process.exit(0), 500);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.0.1",
+	"version": "1.0.3",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",
@@ -23,15 +23,18 @@
 		"dist",
 		"README.md",
 		"package.json",
-		"ARCHITECTURE.md"
+		"ARCHITECTURE.md",
+		"TOOLS.md",
+		"UI_FEATURES.md"
 	],
 	"type": "module",
 	"bin": {
-		"fluxflow-cli": "dist/index.js"
+		"fluxflow-cli": "dist/fluxflow.js",
+		"fluxflow": "dist/fluxflow.js"
 	},
 	"scripts": {
 		"start": "tsx ./src/cli.jsx",
-		"build": "esbuild ./src/cli.jsx --bundle --platform=node --format=esm --outfile=./dist/index.js --external:react --external:ink --external:chalk --external:fs-extra --external:gradient-string --external:ink-text-input --external:ink-select-input --external:ink-spinner --external:ink-multiline-input --external:@google/genai --external:zod --external:duck-duck-scrape --external:nanoid --external:cuimp"
+		"build": "esbuild ./src/cli.jsx --bundle --platform=node --format=esm --outfile=./dist/fluxflow.js --external:react --external:ink --external:chalk --external:fs-extra --external:gradient-string --external:ink-text-input --external:ink-select-input --external:ink-spinner --external:ink-multiline-input --external:@google/genai --external:zod --external:duck-duck-scrape --external:nanoid --external:cuimp"
 	},
 	"dependencies": {
 		"@google/genai": "^1.50.1",