min-agent 3.22.2610252129 → 3.26.2610261326

package/README.md

@@ -52,9 +52,9 @@ min-agent push                  # lightweight shortcut: stage, commit and push (
 min-agent commit                # lightweight shortcut: stage and commit, no push
 min-agent git                  # interactive: provider → model → thinking for commit/push (independent of agent config)
 min-agent light                # interactive: switch → provider → model → thinking; `light off` pauses it
-min-agent --resume <id>         # resume a previous session
+min-agent --resume <id>         # resume a previous session (a unique id prefix is enough)
 min-agent --continue            # resume the most recent session
-min-agent sessions              # list saved sessions (--all shows every entry, --json for scripts)
+min-agent sessions              # list saved sessions (-n 50 shows the latest 50, --all shows every entry, --json for scripts)
 min-agent models --provider x   # list models for a specific provider
 min-agent help [command]        # show help for the root or any subcommand
 min-agent scope global          # share one history across projects (default: per working directory)
@@ -93,6 +93,10 @@ Shortcuts: **Ctrl+C** clears input (press twice to exit) · **Shift+Enter** / **
 
 When the agent asks several questions at once they share one panel: a tab strip at the top shows progress (✓ = answered), **Enter** answers the current question and jumps to the next unanswered one, **Tab** / **Shift+Tab** switch between questions (drafts are kept), and the final 提交 page lists every answer — Enter submits them all (unanswered ones count as skipped), **Esc** cancels the whole set. Long prompts and option lists scroll inside the panel instead of filling the screen. In `exec` the questions are asked one after another; type option numbers (`1,3` for multi-select) or leave a line empty to skip. The Web UI shows the same set as one card with a step per question and a summary step that submits everything together.
 
+## Updates
+
+min-agent checks for new versions at startup in the background (at most once a day, never blocking the session). When one is found you'll see a notice in the chat and the new version is installed in the background via `npm install -g min-agent`; it takes effect the next time you start min-agent. Upgrade failures are silent. Skip the check with `MIN_AGENT_NO_AUTO_UPDATE=1`; check or upgrade manually with `min-agent update [--check]`.
+
 ## Staying in Control
 
 File edits are auto-approved by default; risky actions always ask. When several actions in one step need approval, they're combined into a single prompt instead of a stack of separate ones. Each prompt offers 允许 / 总是允许 / 拒绝 — choosing 总是允许 remembers that action for the current session, so repeated identical commands or MCP tools won't ask again.
@@ -140,6 +144,8 @@ Settings live in `~/.min-agent/config.json` (global). Per-project settings go to
 
 `min-agent settings` prints every active setting in one screen — value, where it comes from (default / global / project / env / this run) and which file to edit.
 
+Each running instance reads config into memory at startup (and again on `/new`, `/resume`, or a serve working-directory switch). Edits from another instance — or from another terminal's CLI — do not affect a running conversation; they apply when the session restarts or a new session starts. The instance's own settings changes still apply immediately.
+
 An optional lighter model (`light.model`, provider optional) shortens long conversations, names the session, tidies long search results, and files notes when memory is on. Leave it empty to keep using the current model. In a terminal, `min-agent light` walks through the switch, provider, model, then thinking intensity; without a terminal it prints the current setting. `min-agent light off` turns it off and keeps the saved model; `min-agent light on` turns it back on. Leave thinking unset to keep it off. In chat, `/light` opens the same picker; `/light on` and `/light off` still change the switch directly.
 
 Conversation history is saved per working directory by default, in `~/.min-agent/sessions/<project-key>/sessions/` — still inside the global config dir, never in the project. To share one history across projects, run `min-agent scope global` (or `/scope global`); `min-agent scope` shows the current setting.
@@ -193,9 +199,9 @@ min-agent push                  # 轻量快捷指令：暂存提交并推送当
 min-agent commit                # 轻量快捷指令：暂存并提交，不推送
 min-agent git                  # 交互式选择 commit/push 的 服务商 → 模型 → 思考强度（不受 agent 配置影响）
 min-agent light                # 交互式选择轻量模型：开关 → 服务商 → 模型 → 思考强度
-min-agent --resume <id>        # 恢复之前的会话
+min-agent --resume <id>        # 恢复之前的会话（输入唯一的 id 前缀即可）
 min-agent --continue           # 继续最近一次会话
-min-agent sessions             # 查看已保存的会话（--all 显示全部，--json 机器可读输出）
+min-agent sessions             # 查看已保存的会话（-n 50 显示最近 50 条，--all 显示全部，--json 机器可读输出）
 min-agent models --provider x  # 查看指定服务商的模型列表
 min-agent help [命令]          # 查看根命令或任意子命令的帮助
 min-agent scope global         # 所有项目共用一个历史（默认按工作目录分别保存）
@@ -234,6 +240,10 @@ min-agent --provider anthropic "..."   # 为一条消息指定服务商
 
 智能体一次提出多个问题时，会在同一个面板里分页显示：顶部标签栏显示进度（已答的带 ✓），**Enter** 回答当前题并跳到下一道未答的题，**Tab** / **Shift+Tab** 在题目之间切换（填了一半的内容会保留），最后一页「提交」汇总所有回答，按 Enter 一起提交（没答的题算跳过），**Esc** 取消整组。题目或选项太长时，面板内部可以滚动，不会把屏幕撑满。`exec` 模式下则按顺序逐题提问，可以输入编号（多选写成 `1,3`），留空表示跳过该题。Web 界面把整组问题放在一张卡片里分步作答，最后在「汇总」一步统一提交。
 
+## 更新
+
+启动时 min-agent 会在后台检查新版本（每天最多一次，不阻塞会话）。发现新版本会在会话里提示，并自动通过 `npm install -g min-agent` 后台升级，下次启动自然生效，升级失败静默忽略。设置 `MIN_AGENT_NO_AUTO_UPDATE=1` 可以关闭；也可以随时手动执行 `min-agent update`（加 `--check` 仅检查）。
+
 ## 掌控风险
 
 文件修改默认自动批准，危险操作仍会询问；同一步里有多个操作需要授权时，会合并成一个弹窗逐条列出，而不是弹出一堆。弹窗提供 允许 / 总是允许 / 拒绝 三个选项——选「总是允许」会在本次会话内记住该操作，之后重复的相同命令或 MCP 工具不再询问。
@@ -283,6 +293,8 @@ min-agent models     # 查看当前服务商可用的模型
 
 `min-agent settings` 一屏列出所有生效设置——当前值、来源（默认 / 全局 / 项目 / 环境变量 / 本次运行）以及该改哪个文件。
 
+每个运行中的实例在启动时把配置读入内存（`/new`、`/resume` 或 serve 切换工作目录时重新读取）。其他实例或另一个终端 CLI 对配置的修改不影响正在进行的对话，要等重启或开新会话才生效；实例自己的设置修改仍然立即生效。
+
 可以另外指定一个轻量模型（`light.model`，服务商可以不填）。它用来压缩较长的对话、给会话起标题、整理过长的搜索结果，以及在开启记忆后整理要记住的内容。留空则这些事情仍使用当前模型。在终端里运行 `min-agent light` 会先选择开关，再选择服务商、模型和思考强度；没有终端时只显示当前设置。`min-agent light off` 关掉开关并保留已选模型，`min-agent light on` 再打开。思考强度留空则关闭。对话里输入 `/light` 会打开同样的逐步选择；`/light on` 和 `/light off` 仍可以直接开关。
 
 对话历史默认按工作目录保存：`~/.min-agent/sessions/<project-key>/sessions/`，同样在全局配置目录下，不会写进项目目录。想让所有项目共用一个历史，执行 `min-agent scope global`（或对话中 `/scope global`）；`min-agent scope` 查看当前设置。