baxian 2.0.5 → 2.0.6

package/README.md

@@ -70,7 +70,7 @@ The server owns task and agent-binding state, drives agents through their tmux p
 > - **Node.js ≥ 22.13**
 > - **tmux** on every machine that runs agents (local and remote)
 > - **Claude Code** (`claude`) and/or **Codex** (`codex`) CLI installed and logged in
-> - **git**, plus the platform CLI your repo needs — **GitHub CLI** (`gh`, authenticated) for GitHub repos; another host needs its own CLI and a matching driver plugin under `~/.baxian/plugins/`
+> - **git**, plus the platform CLI your repo needs — **GitHub CLI** (`gh`, authenticated) for GitHub repos; another host needs its own CLI and a matching driver plugin under the instance home's `plugins/` directory
 >
 > The CLI must be authenticated on every machine that runs agents, and on the server itself: the server calls it to poll reviews, merge, and close PRs, while agents call it to open PRs and post comments.
 
@@ -81,7 +81,7 @@ npm install -g baxian
 baxian
 ```
 
-Open <http://localhost:3000>. The first run creates `~/.baxian/config.json` for you.
+Open <http://localhost:3000>. The first run creates `~/.baxian/baxian.json` for you.
 
 Then, in the console:
 
@@ -93,6 +93,7 @@ Then, in the console:
 
 ```sh
 baxian                    # start the server (default command)
+baxian --home <dir>       # use a separate instance home (or set BAXIAN_HOME)
 baxian status             # status of all agents
 baxian attach <agent-id>  # attach to an agent's tmux session, local or remote
 baxian stop <agent-id>    # interrupt an agent
@@ -102,7 +103,7 @@ baxian task list -p <project>
 
 ## Configuration
 
-baxian reads `./baxian.json` from the working directory first, then falls back to `~/.baxian/config.json` (`baxian start -c <path>` overrides both). A minimal configuration:
+baxian reads `<home>/baxian.json`, where `<home>` defaults to `~/.baxian`. Override the instance home with `baxian --home <dir>` or `BAXIAN_HOME`; the CLI option takes precedence. The working directory is never searched for configuration. A minimal configuration:
 
 ```json
 {

package/README.zh-CN.md

@@ -70,7 +70,7 @@ server 持有任务和 agent 绑定状态，通过 tmux pane 驱动 agent，并
 > - **Node.js ≥ 22.13**
 > - 每台跑 agent 的机器（本地与远程）都装有 **tmux**
 > - **Claude Code**（`claude`）和/或 **Codex**（`codex`）CLI 已安装并登录
-> - **git**，以及仓库平台所需的 CLI —— GitHub 仓库用已认证的 **GitHub CLI**（`gh`）；其它平台需自备 CLI 并在 `~/.baxian/plugins/` 下安装对应的驱动插件
+> - **git**，以及仓库平台所需的 CLI —— GitHub 仓库用已认证的 **GitHub CLI**（`gh`）；其它平台需自备 CLI，并在实例 home 的 `plugins/` 目录下安装对应的驱动插件
 >
 > 该 CLI 需要在每台跑 agent 的机器上、以及 server 本机都完成认证：server 用它轮询评审、合并与关闭 PR，agent 用它开 PR 与发评论。
 
@@ -81,7 +81,7 @@ npm install -g baxian
 baxian
 ```
 
-打开 <http://localhost:3000>。首次运行会自动创建 `~/.baxian/config.json`。
+打开 <http://localhost:3000>。首次运行会自动创建 `~/.baxian/baxian.json`。
 
 然后在控制台里：
 
@@ -93,6 +93,7 @@ baxian
 
 ```sh
 baxian                    # 启动 server（默认命令）
+baxian --home <dir>       # 使用独立实例 home（也可设置 BAXIAN_HOME）
 baxian status             # 查看所有 agent 状态
 baxian attach <agent-id>  # 接入 agent 的 tmux 会话（本地或远程）
 baxian stop <agent-id>    # 打断一个 agent
@@ -102,7 +103,7 @@ baxian task list -p <project>
 
 ## 配置
 
-baxian 优先读取工作目录下的 `./baxian.json`，找不到时回退到 `~/.baxian/config.json`（`baxian start -c <path>` 可覆盖两者）。最小配置：
+baxian 固定读取 `<home>/baxian.json`，`<home>` 默认为 `~/.baxian`。可通过 `baxian --home <dir>` 或 `BAXIAN_HOME` 覆盖实例 home，CLI 参数优先；工作目录中的配置不会被隐式发现。最小配置：
 
 ```json
 {

package/dist/agent/manager.js

@@ -4493,7 +4493,7 @@ export class AgentManager {
                 continue;
             const plugin = this.pluginRegistry.resolveTool(tool);
             if (plugin === undefined) {
-                throw new Error(`project '${project.id}': no git-driver plugin provides tool '${tool}' — install it under ~/.baxian/plugins/ first`);
+                throw new Error(`project '${project.id}': no git-driver plugin provides tool '${tool}' — install it under <home>/plugins/ first`);
             }
             if (this.skillRegistry.pluginSkillNames({ pluginTools: [tool] }).length > 0)
                 continue;