npm - jinzd-ai-cli - Versions diffs - 0.2.2 → 0.2.4 - Mend

jinzd-ai-cli 0.2.2 → 0.2.4

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 (11) hide show

package/README.md +315 -236
package/README.zh-CN.md +328 -161
package/dist/{chunk-YSHQDGVZ.js → chunk-2WCLXWAH.js} +1 -1
package/dist/{chunk-NGGVPDNF.js → chunk-HTXJ23TX.js} +31 -4
package/dist/index.js +4 -4
package/dist/{run-tests-3Y3P7QTJ.js → run-tests-L5G4W7EB.js} +1 -1
package/dist/{server-KZ472I7D.js → server-N2LG3A4M.js} +2 -2
package/package.json +10 -11
package/CLAUDE.md +0 -2124
package/dist/.icon-ico/icon.ico +0 -0
package/dist/electron-server.js +0 -8033

package/README.zh-CN.md CHANGED Viewed

@@ -1,161 +1,328 @@
-[English](README.md) | **中文**
-# ai-cli
-> 跨平台 REPL 风格 AI 对话工具，支持多 Provider 与 Agentic 工具调用
-[![npm version](https://img.shields.io/npm/v/jinzd-ai-cli)](https://www.npmjs.com/package/jinzd-ai-cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-## 特性
-- **多 Provider 支持**：Claude、Gemini、DeepSeek、智谱清言（GLM）、Kimi，可扩展自定义 OpenAI 兼容接口
-- **Agentic 工具调用**：AI 自主执行 bash 命令、读写文件、搜索代码、抓取网页、流式写入大文件
-- **流式输出**：打字机效果，实时展示 AI 响应
-- **会话管理**：自动保存历史，支持跨会话全文搜索
-- **项目上下文注入**：自动读取 `AICLI.md` / `CLAUDE.md` 并注入 system prompt
-- **代理支持**：通过配置或环境变量让 Node.js 走代理（国内用户访问 Gemini/Claude 必备）
-- **独立可执行文件**：打包为单文件 exe，无需安装 Node.js 即可运行
-## 安装
-```bash
-npm install -g jinzd-ai-cli
-```
-需要 Node.js >= 20。
-## 快速开始
-```bash
-aicli
-```
-首次运行会进入交互式配置向导，选择 Provider 并输入 API Key。
-也可运行 `aicli config` 随时修改配置。
-## 支持的 Provider
-| Provider | 说明 | 获取 API Key |
-|---|---|---|
-| **Claude** | Anthropic Claude 系列 | [console.anthropic.com](https://console.anthropic.com) |
-| **Gemini** | Google Gemini 系列（含 2.5 Pro/Flash） | [aistudio.google.com](https://aistudio.google.com) |
-| **DeepSeek** | DeepSeek-Chat / Reasoner | [platform.deepseek.com](https://platform.deepseek.com) |
-| **智谱清言** | GLM-4 系列 | [open.bigmodel.cn](https://open.bigmodel.cn) |
-| **Kimi** | Moonshot AI Kimi 系列 | [platform.moonshot.cn](https://platform.moonshot.cn) |
-## REPL 命令
-| 命令 | 说明 |
-|---|---|
-| `/provider` | 切换 AI Provider |
-| `/model` | 切换模型 |
-| `/clear` | 清空当前对话 |
-| `/session` | 会话管理（new / list / load） |
-| `/search <关键词>` | 跨会话全文搜索历史记录 |
-| `/system <提示词>` | 设置 System Prompt |
-| `/context` | 查看 / 重新加载项目上下文文件 |
-| `/status` | 查看当前状态（Provider / Model / Token 用量） |
-| `/tools` | 列出所有可用 AI 工具 |
-| `/export` | 导出会话（Markdown / JSON） |
-| `/undo` | 撤销上次文件操作 |
-| `/about` | 显示版本和项目信息 |
-| `/help` | 显示帮助 |
-| `/exit` | 退出 |
-## AI 工具（Agentic 能力）
-AI 在对话中可自主调用以下工具：
-| 工具 | 说明 |
-|---|---|
-| `bash` | 执行 shell 命令（Windows: PowerShell，Unix: $SHELL） |
-| `read_file` | 读取文件内容 |
-| `write_file` | 写入文件（需用户确认） |
-| `edit_file` | 精确替换文件内容（需用户确认） |
-| `list_dir` | 列出目录内容 |
-| `grep_files` | 在文件中搜索文本 |
-| `glob_files` | 按 glob 模式匹配文件 |
-| `run_interactive` | 运行交互式程序并依次输入 |
-| `web_fetch` | 抓取网页内容 |
-| `save_last_response` | 保存上一次 AI 回复到文件 |
-危险操作（写入 / 删除）在执行前会提示用户确认。
-## 配置
-配置文件位于 `~/.aicli/config.json`，也可通过 `aicli config` 交互式修改。
-### 代理配置（国内用户）
-Gemini、Claude 等在国内需要代理。支持两种方式：
-**方式一：配置文件（持久）**
-```json
-{
-  "proxy": "http://127.0.0.1:10809"
-}
-```
-运行 `aicli config` → 选择 `Configure proxy` 即可配置。
-**方式二：环境变量（临时）**
-```bash
-# Windows
-set HTTPS_PROXY=http://127.0.0.1:10809
-aicli
-# macOS / Linux
-HTTPS_PROXY=http://127.0.0.1:10809 aicli
-```
-### 项目上下文（类似 CLAUDE.md）
-在项目目录创建 `AICLI.md`，启动时自动注入到 system prompt：
-```bash
-echo "这是一个 TypeScript 项目，使用 ESM 模块..." > AICLI.md
-aicli
-```
-也支持 `CLAUDE.md` 或 `.aicli/context.md`。用 `/context reload` 重新加载。
-## 子命令
-```bash
-aicli                  # 启动 REPL
-aicli config           # 配置向导
-aicli providers        # 列出所有 Provider 及配置状态
-aicli sessions         # 列出最近会话
-```
-## 下载独立可执行文件
-无需 Node.js 环境，直接运行：
-- **Windows**: 从项目 `release/` 目录下载 `ai-cli-win.exe`
-- **macOS**: 下载 `ai-cli-mac`，`chmod +x ai-cli-mac` 后运行
-- **Linux**: 下载 `ai-cli-linux`，`chmod +x ai-cli-linux` 后运行
-## 环境变量
-| 变量 | 说明 |
-|---|---|
-| `AICLI_API_KEY_CLAUDE` | Claude API Key |
-| `AICLI_API_KEY_GEMINI` | Gemini API Key |
-| `AICLI_API_KEY_DEEPSEEK` | DeepSeek API Key |
-| `AICLI_API_KEY_ZHIPU` | 智谱 API Key |
-| `AICLI_API_KEY_KIMI` | Kimi API Key |
-| `AICLI_PROVIDER` | 默认 Provider |
-| `AICLI_NO_STREAM` | 设为 `1` 禁用流式输出 |
-| `HTTPS_PROXY` / `HTTP_PROXY` | 代理地址 |
-## 详细文档
-- [完整使用说明（中文）](docs/USAGE.zh-CN.md)
-- [Full Usage Guide (English)](docs/USAGE.md)
-## License
-MIT
+[English](README.md) | **中文**
+# ai-cli
+> 跨平台 AI 编程助手 — CLI 终端、Web 界面、桌面应用三合一，支持 7 大 Provider 与 Agentic 工具调用
+[![npm version](https://img.shields.io/npm/v/jinzd-ai-cli)](https://www.npmjs.com/package/jinzd-ai-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+[![Tests](https://img.shields.io/badge/tests-138%20passing-brightgreen)]()
+[![GitHub Release](https://img.shields.io/github/v/release/jinzhengdong/ai-cli)](https://github.com/jinzhengdong/ai-cli/releases)
+## 特性亮点
+- **7 大内置 Provider** — Claude、Gemini、DeepSeek、OpenAI、智谱 GLM、Kimi、OpenRouter（300+ 模型）
+- **三种使用方式** — 终端 CLI、浏览器 Web UI（`aicli web`）、Electron 桌面应用
+- **Agentic 工具调用** — AI 自主执行 bash 命令、读写文件、搜索代码、抓取网页、运行测试（每轮最多 25 次）
+- **流式工具调用** — 实时流式展示 AI 推理过程和工具调用
+- **子代理系统** — 将复杂子任务委派给独立子代理执行
+- **深度推理** — Claude Extended Thinking，`/think` 一键切换
+- **规划模式** — `/plan` 进入只读规划，AI 先分析后执行
+- **MCP 协议** — 接入外部 MCP 服务器，动态发现工具
+- **多用户认证** — Web UI 支持多用户密码登录
+- **PWA 支持** — Web UI 可安装为桌面/移动应用，支持局域网访问
+- **三层级上下文** — 全局 / 项目 / 子目录上下文文件自动注入
+- **无头模式** — `aicli -p "提示词"` 用于 CI/CD 管道和脚本
+- **35+ REPL 命令** — 会话管理、检查点、代码审查、脚手架等
+- **跨平台** — Windows、macOS、Linux
+## 安装
+### npm 安装（推荐）
+```bash
+npm install -g jinzd-ai-cli
+```
+需要 Node.js >= 20。安装后使用 `aicli` 启动。
+### Electron 桌面应用（Windows）
+从 [GitHub Releases](https://github.com/jinzhengdong/ai-cli/releases) 下载安装包，无需 Node.js：
+| 平台 | 下载 |
+|------|------|
+| Windows x64 | [`ai-cli-setup.exe`](https://github.com/jinzhengdong/ai-cli/releases/latest) |
+### 独立可执行文件
+预编译 CLI 二进制（无需 Node.js，约 56 MB）：
+| 平台 | 文件 |
+|------|------|
+| Windows x64 | `ai-cli-win.exe` |
+| macOS arm64 | `ai-cli-mac` |
+| macOS x64 | `ai-cli-mac-x64` |
+| Linux x64 | `ai-cli-linux` |
+## 快速开始
+### 终端 CLI
+```bash
+aicli
+```
+首次运行会进入交互式配置向导，选择 Provider 并输入 API Key。配置保存在 `~/.aicli/config.json`。
+```
+[deepseek] > 你好！帮我分析一下这个项目
+[deepseek] > @src/main.ts 审查这个文件有没有 bug
+[deepseek] > @screenshot.png 这张图片里有什么？
+[deepseek] > /help
+```
+使用 `@文件路径` 在提示词中引用文件或图片。
+### Web UI
+```bash
+aicli web                    # 在 localhost:3456 启动
+aicli web --port 8080        # 自定义端口
+aicli web --host 0.0.0.0    # 局域网访问（手机/平板）
+```
+功能：多 Tab 会话、文件树面板、拖拽/粘贴图片、Prompt 模板库、8 套 DaisyUI 主题、PWA 可安装、键盘快捷键、Diff 语法高亮。
+### 用户管理
+```bash
+aicli user create admin      # 创建用户（启用认证）
+aicli user list              # 列出所有用户
+aicli user reset-password x  # 重置密码
+aicli user delete x          # 删除用户
+```
+## 支持的 Provider
+| Provider | 模型 | 获取 API Key |
+|----------|------|-------------|
+| **Claude** | Opus 4, Sonnet 4, Haiku 4 | [console.anthropic.com](https://console.anthropic.com) |
+| **Gemini** | 2.5 Pro, 2.5 Flash | [aistudio.google.com](https://aistudio.google.com) |
+| **DeepSeek** | DeepSeek-Chat (V3), Reasoner (R1) | [platform.deepseek.com](https://platform.deepseek.com) |
+| **OpenAI** | GPT-5.4, GPT-4o, o3, o4-mini | [platform.openai.com](https://platform.openai.com) |
+| **OpenRouter** | 300+ 模型（Claude/GPT/Gemini/Llama/Qwen/Mistral...） | [openrouter.ai](https://openrouter.ai) |
+| **智谱清言** | GLM-4, GLM-5 | [open.bigmodel.cn](https://open.bigmodel.cn) |
+| **Kimi** | Moonshot, Kimi-K2 | [platform.moonshot.cn](https://platform.moonshot.cn) |
+也可通过 `customBaseUrls` 配置接入任意 OpenAI 兼容 API。
+## 内置工具（Agentic 能力）
+AI 在对话中可自主调用 16 个工具：
+| 工具 | 安全级别 | 说明 |
+|------|---------|------|
+| `bash` | 动态判断 | 执行 shell 命令（Windows: PowerShell，Unix: $SHELL） |
+| `read_file` | 安全 | 读取文件内容（10 MB 限制，支持图片） |
+| `write_file` | 写入 | 创建/覆盖文件（diff 预览 + 确认） |
+| `edit_file` | 写入 | 精确字符串替换，模糊匹配提示 |
+| `list_dir` | 安全 | 列出目录内容 |
+| `grep_files` | 安全 | 正则搜索文件内容 |
+| `glob_files` | 安全 | 按 glob 模式匹配文件 |
+| `web_fetch` | 安全 | 抓取网页转 Markdown（防 SSRF） |
+| `google_search` | 安全 | Google 自定义搜索 |
+| `run_interactive` | 安全 | 运行交互式程序并输入 |
+| `run_tests` | 安全 | 自动检测并运行测试（JUnit XML 解析） |
+| `spawn_agent` | 安全 | 委派子任务给隔离子代理 |
+| `ask_user` | 安全 | 暂停并向用户提问 |
+| `save_memory` | 安全 | 跨会话持久化重要信息 |
+| `write_todos` | 安全 | 任务拆解，终端实时渲染进度 |
+| `save_last_response` | 写入 | 保存 AI 回复到文件 |
+**安全级别**：`安全` = 自动执行，`写入` = diff 预览 + 确认，`破坏性` = 醒目警告 + 确认。
+## 主要 REPL 命令
+| 命令 | 说明 |
+|------|------|
+| `/provider` | 切换 AI Provider |
+| `/model` | 切换模型 |
+| `/plan` | 进入只读规划模式 |
+| `/think` | 切换 Claude 深度推理 |
+| `/test` | 自动检测并运行测试 |
+| `/review` | AI 代码审查 git diff |
+| `/scaffold <描述>` | AI 生成项目骨架 |
+| `/init` | AI 生成项目上下文文件 |
+| `/compact` | 压缩对话历史 |
+| `/session` | 会话管理（new / list / load） |
+| `/checkpoint` | 保存/恢复会话检查点 |
+| `/fork` | 从当前位置或检查点分叉对话 |
+| `/search <关键词>` | 跨会话全文搜索 |
+| `/skill` | 管理 Agent 技能包 |
+| `/mcp` | 查看 MCP 服务器状态 |
+| `/cost` | 显示 Token 用量统计 |
+| `/undo` | 撤销上次文件操作 |
+| `/doctor` | 健康检查（API Key、MCP、上下文） |
+| `/export` | 导出会话为 Markdown 或 JSON |
+| `/config` | 打开配置向导 |
+| `/help` | 显示所有命令 |
+完整命令参考见 [使用说明](USAGE.md)。
+## CLI 参数
+```bash
+aicli [选项]
+选项:
+  --provider <名称>        设置 AI Provider
+  -m, --model <名称>       设置模型
+  -p, --prompt <文本>      无头模式：单次提问后退出
+  --system <提示词>        覆盖 system prompt
+  --json                   输出 JSON（无头模式）
+  --output-format <格式>   text | streaming-json (NDJSON)
+  --resume <id>            恢复之前的会话
+  --allowed-tools <列表>   逗号分隔的工具白名单
+  --blocked-tools <列表>   逗号分隔的工具黑名单
+  --no-stream              禁用流式输出
+子命令:
+  aicli web [选项]         启动 Web UI 服务器
+  aicli config             运行配置向导
+  aicli providers          列出所有 Provider
+  aicli sessions           列出最近会话
+  aicli user <操作>        管理 Web UI 用户
+```
+### 无头模式
+```bash
+# 单次提问
+aicli -p "用一句话解释递归"
+# 管道输入
+cat src/main.ts | aicli -p "审查这段代码"
+# JSON 输出用于脚本
+aicli -p "hello" --json
+# 流式 JSON (NDJSON)
+aicli -p "写一首诗" --output-format streaming-json
+```
+## 配置
+配置文件位于 `~/.aicli/config.json`。运行 `aicli config` 打开交互式向导，或直接编辑：
+```json
+{
+  "defaultProvider": "deepseek",
+  "apiKeys": {
+    "deepseek": "sk-...",
+    "claude": "sk-ant-...",
+    "openrouter": "sk-or-..."
+  },
+  "proxy": "http://127.0.0.1:10809",
+  "mcpServers": { },
+  "ui": {
+    "theme": "dark",
+    "wordWrap": 0,
+    "notificationThreshold": 10000
+  }
+}
+```
+### 代理配置（国内用户）
+Gemini、Claude 等在国内需要代理：
+**方式一：配置文件（持久）**
+```json
+{
+  "proxy": "http://127.0.0.1:10809"
+}
+```
+运行 `aicli config` → 选择 `Configure proxy` 即可配置。
+**方式二：环境变量（临时）**
+```bash
+# Windows
+set HTTPS_PROXY=http://127.0.0.1:10809
+aicli
+# macOS / Linux
+HTTPS_PROXY=http://127.0.0.1:10809 aicli
+```
+### 环境变量
+| 变量 | 说明 |
+|------|------|
+| `AICLI_API_KEY_CLAUDE` | Claude API Key |
+| `AICLI_API_KEY_GEMINI` | Gemini API Key |
+| `AICLI_API_KEY_DEEPSEEK` | DeepSeek API Key |
+| `AICLI_API_KEY_OPENAI` | OpenAI API Key |
+| `AICLI_API_KEY_OPENROUTER` | OpenRouter API Key |
+| `AICLI_API_KEY_ZHIPU` | 智谱 API Key |
+| `AICLI_API_KEY_KIMI` | Kimi API Key |
+| `AICLI_PROVIDER` | 默认 Provider |
+| `AICLI_NO_STREAM` | 设为 `1` 禁用流式输出 |
+| `HTTPS_PROXY` / `HTTP_PROXY` | 代理地址 |
+### 三层级上下文文件
+ai-cli 自动发现并注入上下文文件到 system prompt：
+| 层级 | 路径 | 用途 |
+|------|------|------|
+| 全局层 | `~/.aicli/AICLI.md` | 所有项目通用的个人偏好 |
+| 项目层 | `<git-root>/AICLI.md` | 项目级规则（提交到 git 供团队共享） |
+| 子目录层 | `<cwd>/AICLI.md` | 当前子目录的特定指令 |
+每层也支持 `CLAUDE.md` 作为备选文件名。
+### MCP 集成
+接入外部 [MCP](https://modelcontextprotocol.io/) 服务器，动态发现工具。配置格式兼容 Claude Desktop：
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
+      "timeout": 30000
+    }
+  }
+}
+```
+支持项目级 `.mcp.json`，与全局配置自动合并。
+## Web UI 功能
+Web UI（`aicli web`）提供功能完备的浏览器界面：
+- **多 Tab 会话** — 多个浏览器标签页并行对话
+- **文件树面板** — 浏览项目目录，点击插入 `@path` 引用
+- **图片上传** — 拖拽或 Ctrl+V 粘贴图片到聊天
+- **Prompt 模板库** — CRUD + 标签 + 搜索 + 导入导出
+- **8 套主题** — DaisyUI 主题，代码高亮自动联动
+- **Diff 语法高亮** — 工具确认对话框中彩色 diff
+- **键盘快捷键** — `Esc` 停止、`Ctrl+L` 清屏、`↑↓` 历史
+- **导出** — `/export md` 或 `/export json` 浏览器下载
+- **PWA** — 可安装为桌面/移动应用
+- **局域网访问** — `--host 0.0.0.0` 供手机/平板访问
+- **多用户认证** — 密码认证 + 用户数据隔离
+- **自动重连** — 心跳 + 指数退避重连
+## 测试
+```bash
+npm test              # 运行全部 138 个测试
+npm run test:watch    # 监听模式
+```
+8 个测试套件覆盖：认证、会话、工具类型与危险级别、权限、输出截断、diff 渲染、edit-file 相似度、错误层级。
+## 文档
+- [完整使用说明](USAGE.md) — 所有功能的详细参考
+- [English README](README.md) — English documentation
+## License
+[MIT](LICENSE)

package/dist/{chunk-YSHQDGVZ.js → chunk-2WCLXWAH.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import { platform } from "os";
 import chalk from "chalk";
 // src/core/constants.ts
-var VERSION = "0.2.2";
+var VERSION = "0.2.4";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{chunk-NGGVPDNF.js → chunk-HTXJ23TX.js} RENAMED Viewed

@@ -16,7 +16,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   runTestsTool
-} from "./chunk-YSHQDGVZ.js";
+} from "./chunk-2WCLXWAH.js";
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -2704,11 +2704,14 @@ Important rules:
 1. Each bash call runs in an independent subprocess; cd commands do not persist. To run in a specific directory, use the cwd parameter, or combine commands: e.g. "cd mydir; ls" or "mkdir mydir; cd mydir; New-Item file.txt".
 2. If a command fails (returns an error or non-zero exit code), stop immediately, report the error to the user, and do not retry the same or similar commands.
 3. Multiple commands can be combined with semicolons in a single call to reduce rounds.
-4. To delete directories, use Remove-Item -Recurse (the system will automatically optimize to a more reliable method).` : `Execute commands in ${SHELL}.
+4. To delete directories, use Remove-Item -Recurse (the system will automatically optimize to a more reliable method).
+5. IMPORTANT: On Windows, "curl" is an alias for Invoke-WebRequest and does NOT support curl flags like -s, -X, -H. Use Invoke-RestMethod instead for HTTP requests. Example: Invoke-RestMethod -Uri "http://localhost:3000/api/health" -Method Get
+6. For long-running server commands (node server.js, npm run dev, etc.), use Start-Process -NoNewWindow to run in background, otherwise the tool will block until timeout.` : `Execute commands in ${SHELL}.
 Important rules:
 1. Each bash call runs in an independent subprocess; cd commands do not persist. To run in a specific directory, use the cwd parameter, or combine commands: e.g. "cd mydir && ls" or "mkdir -p mydir && touch mydir/file.txt".
 2. If a command fails (returns an error or non-zero exit code), stop immediately, report the error to the user, and do not retry the same or similar commands.
-3. Multiple commands can be combined with && in a single call to reduce rounds.`,
+3. Multiple commands can be combined with && in a single call to reduce rounds.
+4. For long-running server commands (node server.js, npm start, npm run dev, etc.), run in background with & or nohup, otherwise the tool will block until timeout.`,
     parameters: {
       command: {
         type: "string",
@@ -3228,10 +3231,11 @@ var editFileTool = {
   definition: {
     name: "edit_file",
     description: `Precisely edit file contents. Supports three modes:
-1. String replace (most common): Provide old_str and new_str to replace an exact match. old_str must appear exactly once in the file.
+1. String replace (most common): Provide old_str and new_str to replace an exact match. old_str must appear exactly once in the file (unless replace_all is true).
 2. Line insert: Provide insert_after_line (1-based line number) and insert_content to insert after that line.
 3. Line delete: Provide delete_from_line and delete_to_line (inclusive) to delete that range.
 Optional ignore_whitespace: true to match ignoring indentation differences.
+Optional replace_all: true to replace ALL occurrences of old_str in the file at once (saves tool rounds when renaming variables/functions).
 Note: Path can be absolute or relative to the current working directory.`,
     parameters: {
       path: {
@@ -3254,6 +3258,11 @@ Note: Path can be absolute or relative to the current working directory.`,
         description: "[Replace mode] Whether to ignore leading/trailing whitespace per line when matching, defaults to false",
         required: false
       },
+      replace_all: {
+        type: "boolean",
+        description: "[Replace mode] Replace ALL occurrences of old_str instead of requiring unique match. Useful for renaming variables/functions across the file in one call.",
+        required: false
+      },
       insert_after_line: {
         type: "number",
         description: "[Insert mode] Insert after this line number (1-based), 0 means insert at the beginning",
@@ -3293,6 +3302,7 @@ Note: Path can be absolute or relative to the current working directory.`,
       const oldStr = String(args["old_str"]);
       const newStr = String(args["new_str"] ?? "");
       const ignoreWs = Boolean(args["ignore_whitespace"]);
+      const replaceAll = Boolean(args["replace_all"]);
       if (oldStr === "") throw new Error("old_str cannot be empty");
       if (ignoreWs) {
         const fileLines = original.split("\n");
@@ -3320,6 +3330,23 @@ Please read the file first and use exact text.`;
   Replaced: ${searchLines.length} line(s) \u2192 ${newStr.split("\n").length} line(s)
   Old: ${truncatePreview(oldStr)}
   New: ${truncatePreview(newStr)}`;
+      }
+      if (replaceAll) {
+        const occurrences = original.split(oldStr).length - 1;
+        if (occurrences === 0) {
+          const similar = findSimilarLines(original, oldStr);
+          const hint = similar.length > 0 ? `
+Similar lines found (did you mean?):
+${similar.join("\n")}` : "";
+          return `ERROR: old_str not found in file.${hint}
+Please read the file first and use exact text.`;
+        }
+        undoStack.push(filePath, `edit_file (replace_all): ${filePath}`);
+        const updated2 = original.split(oldStr).join(newStr);
+        writeFileSync5(filePath, updated2, encoding);
+        return `Successfully edited ${filePath} (replace_all)
+  Replaced: ${occurrences} occurrence(s) of ${truncatePreview(oldStr)}
+  With: ${truncatePreview(newStr)}`;
       }
       const firstIndex = original.indexOf(oldStr);
       if (firstIndex === -1) {

package/dist/index.js CHANGED Viewed

@@ -35,7 +35,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-NGGVPDNF.js";
+} from "./chunk-HTXJ23TX.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -55,7 +55,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-YSHQDGVZ.js";
+} from "./chunk-2WCLXWAH.js";
 // src/index.ts
 import { program } from "commander";
@@ -1904,7 +1904,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-3Y3P7QTJ.js");
+        const { executeTests } = await import("./run-tests-L5G4W7EB.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -5292,7 +5292,7 @@ program.command("web").description("Start Web UI server with browser-based chat
     console.error("Error: Invalid port number. Must be between 1 and 65535.");
     process.exit(1);
   }
-  const { startWebServer } = await import("./server-KZ472I7D.js");
+  const { startWebServer } = await import("./server-N2LG3A4M.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("user [action] [username]").description("Manage Web UI users (list | create <name> | delete <name> | reset-password <name> | migrate <name>)").action(async (action, username) => {

package/dist/{run-tests-3Y3P7QTJ.js → run-tests-L5G4W7EB.js} RENAMED Viewed

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-YSHQDGVZ.js";
+} from "./chunk-2WCLXWAH.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-KZ472I7D.js → server-N2LG3A4M.js} RENAMED Viewed

@@ -23,7 +23,7 @@ import {
   setupProxy,
   spawnAgentContext,
   truncateOutput
-} from "./chunk-NGGVPDNF.js";
+} from "./chunk-HTXJ23TX.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   CONTEXT_FILE_CANDIDATES,
@@ -35,7 +35,7 @@ import {
   PLAN_MODE_SYSTEM_ADDON,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-YSHQDGVZ.js";
+} from "./chunk-2WCLXWAH.js";
 import {
   AuthManager
 } from "./chunk-CPLT6CD3.js";