@tcb-sandbox/cli 0.3.7

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+版本变更只记在此文件，不写进 README。
+
+## 0.3.7
+
+- `serve` 增加别名 **`local`**。
+- 用户文档拆成 **`docs/thin-client.md`**（薄客户端）与 **`docs/local-mode.md`**（本地 serve）；README 只做入口与维护说明。
+
+## 0.3.6
+
+- 内置 TRW（`dist/trw-embedded.js` + `dist/trw-version.json`）；`serve` 不再要求 `--trw-entry`。
+- 运行时依赖 **`node-pty`**、**`@mongodb-js/zstd`**。
+
+## 0.3.0
+
+- 离线工具文档快照；MCP 工具名为 `add_mcp_servers`、`remove_mcp_servers`、`list_mcp_servers`。
+
+**升级提示：** 服务端需暴露上述 `*_mcp_servers`；否则可暂时固定 **`@tcb-sandbox/cli@0.2.1`** 直到服务端升级。

package/README.md

@@ -0,0 +1,67 @@
+# @tcb-sandbox/cli
+
+面向 **TRW（tcb-remote-workspace）** 的命令行工具：**一种安装，两种用法**。
+
+> **目录位置：** `clis/sandbox-cli/`
+
+| 用法 | 说明 |
+|------|------|
+| **本机起服务** | `tcb-sandbox serve`（或 `local`）在本地跑内置 TRW，默认 `http://127.0.0.1:9000`。 |
+| **只当客户端** | 其它子命令都是 **HTTP 薄客户端**，用 `--endpoint` / `--session-id` 连已有 TRW（远端或本机均可）。 |
+
+**文档（建议按顺序看）：** [快速上手](./docs/quick-start.md) → [薄客户端](./docs/thin-client.md) → [本地 serve](./docs/local-mode.md) → [文档索引](./docs/README.md) → [变更记录](./CHANGELOG.md)
+
+---
+
+## 安装
+
+任选一种全局安装方式：
+
+```bash
+npm install -g @tcb-sandbox/cli
+```
+
+```bash
+pnpm add -g @tcb-sandbox/cli
+```
+
+安装后可用命令名：**`tcb-sandbox`**（主名）、**`tcb-sandbox`**（别名）。
+
+---
+
+## 最短路径
+
+```bash
+tcb-sandbox serve
+# 另开终端
+tcb-sandbox --endpoint http://127.0.0.1:9000 --session-id my-session health
+```
+
+serve 之后 TRW **六大门面**（HTTP API、`/mcp`、`/mcp_user_define`、CLI、Skills、E2B）及探活/文档/预览，见 **[docs/quick-start.md](./docs/quick-start.md)**。
+
+---
+
+## 使用前提（读一遍即可）
+
+- **TRW 没有单独发 npm 包**；本地模式用的是本包自带的 **`dist/trw-embedded.js`**（esbuild 打好的服务）。
+- 需要 **node-pty**、**@mongodb-js/zstd**：已写在包的 `dependencies` 里，给内置 bundle 动态加载用。
+- 想用**自己编出来的 TRW** 替代内置文件：设环境变量 **`TCB_SANDBOX_TRW_ENTRY`** 指向你的 `dist/index.js` 等入口（见 [local-mode.md](./docs/local-mode.md)）。
+- 公开展示的相关仓库还有 **@tcb-sandbox/e2b-sandbox-adapter** 等；**npm 上搜不到名叫 TRW 的包**是正常的。
+- 连远端 TRW 时**不会**在 CLI 里写死密钥；工具列表优先走 **`GET /api/docs`**（离线时 CLI 可能用内置文档快照）。
+
+---
+
+## 仓库内维护 / 发布
+
+以下在 **tcb-remote-workspace** monorepo **根目录**执行（发布前请再跑一遍 test）：
+
+```bash
+pnpm --filter @tcb-sandbox/cli run build
+pnpm --filter @tcb-sandbox/cli run test
+pnpm --filter @tcb-sandbox/cli run pack:dry-run
+pnpm --filter @tcb-sandbox/cli run pack:safety   # 拒绝把 .env、src、tests、*.map 打进包
+pnpm --filter @tcb-sandbox/cli version patch     # 或 minor / major
+pnpm --filter @tcb-sandbox/cli publish
+```
+
+可选：包内 **live 测试** 读 `cli/.env`（参考 `.env.example`）。