mirocode 0.14.2 → 0.15.0

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   A terminal client for ACP-compatible coding agents.<br>
-  Interactive TUI and one-shot print mode, built with Bun, React, and Ink.
+  Interactive TUI and one-shot print mode, built with Bun.
 </p>
 
 <p align="center">
@@ -51,7 +51,7 @@ bun run build
 
 `bun run build:js` emits an inspectable ESM bundle instead of a compiled binary.
 
-Release tags (`v*`) publish Linux and macOS binaries (x64 and arm64). Local cross-compiles use the same flags as CI:
+Release tags (`v*`) publish the npm package only; no GitHub Release binaries are built. Manual cross-compiles use:
 
 ```bash
 bun run scripts/build.ts --target bun-linux-x64 --outfile dist/miro-linux-amd64
@@ -162,7 +162,16 @@ Visible thinking blocks retain only metadata; Miro model-context checkpoints als
 
 ## ACP providers
 
-Miro uses its built-in agent by default. Start an ACP provider explicitly with `miro --acp <id>`; its binary must be on `PATH`. Add or override ACP definitions in `~/.miro/settings.json` under `providers.<id>` = `{ command | bin, args, name }`. Miro stores an ACP provider's last `/model` and `/effort` choice as `model` / `effort` in that same entry.
+Miro uses its built-in agent by default. Start an ACP provider explicitly with `miro --acp <id>`; its binary must be on `PATH`. Add or override ACP definitions in `~/.miro/acp.json`, whose top level maps each id to `{ command | bin, args, name, sessionMeta }`:
+
+```json
+{
+  "knot": { "command": "knot-cli", "args": ["acp"] },
+  "my-cursor": { "command": "cursor-agent", "args": ["acp"], "name": "Cursor (work)" }
+}
+```
+
+Miro stores an ACP provider's last `/model` and `/effort` choice as `model` / `effort` in that same entry. The `providers` object in `~/.miro/settings.json` is no longer read.
 
 | Id | Name | Binary |
 |----|------|--------|
@@ -234,7 +243,7 @@ If `models.json` is missing or has no usable models, miro falls back to the `mir
 
 Use `/config sandbox on` or `/config sandbox off` to update this setting and switch the command tool's sandboxing in the current session.
 
-`/model` and `/effort` choices are remembered per provider. Miro uses top-level `model` / `effort` in `settings.json`, and records the model as `provider/id`; an ACP provider uses its own `providers.<id>` entry. The `model` / `effort` entries inside `miro` are fallback defaults when the top-level preference is absent or unavailable. Miro's `Default` / `Plan` interaction mode is independent from its `Auto` / `Manual` permission mode; `Shift+Tab` cycles the interaction mode.
+`/model` and `/effort` choices are remembered per provider. Miro uses top-level `model` / `effort` in `settings.json`, and records the model as `provider/id`; an ACP provider keeps its own entry in `~/.miro/acp.json`. The `model` / `effort` entries inside `miro` are fallback defaults when the top-level preference is absent or unavailable. Miro's `Default` / `Plan` interaction mode is independent from its `Auto` / `Manual` permission mode; `Shift+Tab` cycles the interaction mode.
 
 ### Codemode (experimental)
 
@@ -310,7 +319,7 @@ Composer history is independent of the transcript, at `~/.miro/history.jsonl`.
 
 ## Configuration
 
-Model, effort, prompt-language, status-line, and custom ACP-provider preferences live in `~/.miro/settings.json`. Its legacy top-level `provider` value is ignored. Miro LLM endpoints and models are imported only from `~/.miro/models.json`. `/config` changes both the live ACP options advertised as `configOptions` and miro's own `language` option.
+Model, effort, prompt-language, and status-line preferences live in `~/.miro/settings.json`; ACP provider definitions and their own `model` / `effort` preferences live in `~/.miro/acp.json`. A legacy top-level `provider` value in `settings.json` is ignored, as is its `providers` object. Miro LLM endpoints and models are imported only from `~/.miro/models.json`. `/config` changes both the live ACP options advertised as `configOptions` and miro's own `language` option.
 
 ### Permission mode
 

package/README.zh.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   面向 ACP 兼容编程智能体的终端客户端。<br>
-  支持交互式 TUI 与一次性打印模式，基于 Bun、React 与 Ink。
+  支持交互式 TUI 与一次性打印模式，基于 Bun。
 </p>
 
 <p align="center">
@@ -51,7 +51,7 @@ bun run build
 
 `bun run build:js` 会生成可检查的 ESM 包，而不是编译后的二进制。
 
-带 `v*` 的发布标签会构建 Linux / macOS（x64 与 arm64）二进制。本地交叉编译与 CI 使用相同参数：
+带 `v*` 的发布标签只发布 npm 包，不再构建 GitHub Release 二进制。手动交叉编译使用：
 
 ```bash
 bun run scripts/build.ts --target bun-linux-x64 --outfile dist/miro-linux-amd64
@@ -162,7 +162,16 @@ ACP 声明的提供方专用斜杠命令会原样转发。
 
 ## ACP 提供方
 
-Miro 默认使用自带 agent。要进入 ACP，显式使用 `miro --acp <id>`；对应二进制必须在 `PATH` 上。也可以在 `~/.miro/settings.json` 的 `providers.<id>` = `{ command | bin, args, name }` 新增或覆盖 ACP 定义。Miro 会把 ACP 提供方上次 `/model` 与 `/effort` 的选择记在同一条目的 `model` / `effort` 里。
+Miro 默认使用自带 agent。要进入 ACP，显式使用 `miro --acp <id>`；对应二进制必须在 `PATH` 上。也可以在 `~/.miro/acp.json` 新增或覆盖 ACP 定义，该文件顶层就是 id → `{ command | bin, args, name, sessionMeta }` 的表：
+
+```json
+{
+  "knot": { "command": "knot-cli", "args": ["acp"] },
+  "my-cursor": { "command": "cursor-agent", "args": ["acp"], "name": "Cursor (work)" }
+}
+```
+
+Miro 会把 ACP 提供方上次 `/model` 与 `/effort` 的选择记在同一条目的 `model` / `effort` 里。`~/.miro/settings.json` 里的 `providers` 字段不再读取。
 
 | Id | 名称 | 二进制 |
 |----|------|--------|
@@ -234,7 +243,7 @@ miro 用到的上游写在 `~/.miro/models.json`。打开 `/model` 会重新读
 
 可用 `/config sandbox on` 或 `/config sandbox off` 持久化修改这个开关，并立即切换当前会话命令工具的沙箱状态。
 
-`/model` 与 `/effort` 的选择按提供方分别记忆。`miro` 使用 `settings.json` 顶层的 `model` / `effort`，其中 `model` 记为 `provider/id`；ACP 提供方则存在自己的 `providers.<id>` 条目里。`miro` 对象里的 `model` / `effort` 只在顶层偏好缺省或匹配不到时作为回退默认值。miro 的 `Default` / `Plan` 交互模式与 `Auto` / `Manual` 权限模式相互独立；`Shift+Tab` 循环交互模式。
+`/model` 与 `/effort` 的选择按提供方分别记忆。`miro` 使用 `settings.json` 顶层的 `model` / `effort`，其中 `model` 记为 `provider/id`；ACP 提供方则存在 `~/.miro/acp.json` 自己的条目里。`miro` 对象里的 `model` / `effort` 只在顶层偏好缺省或匹配不到时作为回退默认值。miro 的 `Default` / `Plan` 交互模式与 `Auto` / `Manual` 权限模式相互独立；`Shift+Tab` 循环交互模式。
 
 ### Codemode（实验性）
 
@@ -310,7 +319,7 @@ miro 会在可见聊天记录之外保存模型上下文检查点，包含压缩
 
 ## 配置
 
-模型、努力程度、提示词语言、状态栏和自定义 ACP 提供方偏好保存在 `~/.miro/settings.json`；其中遗留的顶层 `provider` 会被忽略。miro 的上游与模型列表只从 `~/.miro/models.json` 导入。`/config` 既可修改 ACP 以 `configOptions` 声明的实时选项，也可修改 miro 自己的 `language` 选项。
+模型、努力程度、提示词语言与状态栏偏好保存在 `~/.miro/settings.json`；ACP 提供方定义与它们各自的 `model` / `effort` 偏好保存在 `~/.miro/acp.json`。`settings.json` 里遗留的顶层 `provider` 与 `providers` 字段都会被忽略。miro 的上游与模型列表只从 `~/.miro/models.json` 导入。`/config` 既可修改 ACP 以 `configOptions` 声明的实时选项，也可修改 miro 自己的 `language` 选项。
 
 ### 权限模式