pisper 0.5.13 → 0.5.14-darwin-x64.0

package/README.md

@@ -1,226 +1,53 @@
-# Pisper TUI
+# Pisper TUI Command Reference
 
-![Pisper TUI 启动画面](https://ling-kong-ran.github.io/pisper/shots/cli.png)
+[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper) · [中文](./README.md)
 
-![Pisper TUI Chat 与实时活动](https://ling-kong-ran.github.io/pisper/shots/cli-chat.png)
+Argument notation: `<argument>` is required; `[argument]` is optional.
 
-[项目主页](https://ling-kong-ran.github.io/pisper/) · [GitHub 仓库](https://github.com/ling-kong-ran/pisper)
+## CLI Commands
 
-[English guide](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.en.md)
-
-## 安装终端命令
-
-需要 Node.js 20+。安装后直接运行 `pisper`：
-
-```bash
-npm install -g pisper --progress=true --foreground-scripts
-pisper
-```
-
-使用 npm 镜像时，平台包会走同一个 registry。`--progress=true` 显示 npm 下载进度，`--foreground-scripts` 显示本地验签和解压阶段；需要查看请求和缓存明细时再增加 `--loglevel=info`：
-
-```bash
-npm install -g pisper --registry=https://registry.npmmirror.com --progress=true --foreground-scripts
-```
-
-安装 Pisper 桌面版后，也可以打开 **设置 → 应用更新**，安装、修复或卸载 `pisper` 命令。Pisper 将可执行文件安装到当前用户目录并管理对应的 `PATH` 项，不需要管理员权限。
-
-通过桌面版安装或卸载后需要完全重启终端宿主：Windows Terminal 需退出全部窗口后重开，IDE 内置终端需重启 IDE。
-
-也可以从源码构建完整发行目录：
-
-```bash
-npm run sidecar:sea
-npm run tui:package
-```
-
-产物位于：
-
-```text
-release/tui/pisper-<version>-<platform>-<arch>/
-├── pisper[.exe]
-├── pisper-sidecar[.exe]
-└── sidecar-runtime/
-```
-
-## 发行版更新
-
-检查或更新 npm 安装的 Pisper：
-
-```bash
-pisper update --check
-pisper update
-```
-
-命令使用当前配置的 npm registry。桌面版更新在 **设置 → 应用更新** 中管理。
-
-## Provider 与可选 Web 配置
-
-首次进入 TUI 后输入 `/provider` 并选择 Provider，即可编辑协议类型、Base URL 和 API Key。Base URL 会预填 Runtime 当前生效地址：未自定义时显示官方默认地址，已自定义时显示自定义地址；API Key 留空会保留已保存的密钥。使用 `Up`/`Down` 或 `Tab` 切换字段，使用 `Left`/`Right` 选择协议，`Enter` 保存，`Esc` 返回 Provider 列表或取消。API Key 使用独立掩码输入，粘贴时会移除空白字符，且密钥不会进入 composer、Slash 历史或 Runtime 的普通配置响应。已知 Provider 可直接输入 `/provider <id>` 跳过选择，例如 `/provider deepseek`；`/apikey` 保留为兼容别名，功能相同。
-
-需要完整可视化配置时运行：
-
-```bash
-pisper web
-```
-
-该命令在默认浏览器打开本机 Provider 设置；浏览器使用期间需保持终端中的 Pisper 进程运行。**保存 Provider 配置**只保存当前连接，**设为默认 Provider**才会修改后续会话的默认模型。
-
-Web 前端已安装时，可在 TUI 中输入 `/web` 再次打开配置页；尚未安装时先退出并运行 `pisper web`。
-
-## 启动与会话
-
-在项目目录运行：
-
-```bash
-pisper
-```
-
-普通 `pisper` 始终创建空会话，不会自动打开历史记录。显式使用 `resume` 会打开跨所有目录的交互式会话列表；使用方向键选择，按 `Enter` 恢复，按 `Esc` 退出：
-
-```bash
-pisper resume
-```
-
-没有历史会话时，`pisper resume` 会提示后退出，不会创建新会话。恢复只使用会话已保存的工作目录，不会将其改写为 TUI 启动目录。进入会话后可通过 `/dir <目录>` 显式修改该会话的工作目录；相对路径以当前会话目录为基准。
-
-指定其他工作目录创建新会话：
-
-```bash
-pisper --cwd /path/to/project
-```
-
-诊断 sidecar、鉴权和能力目录：
-
-```bash
-pisper doctor
-```
-
-诊断输出会列出 sidecar 连接来源、TUI 启动目录、sidecar runtime fallback 目录，以及该目录下最近的会话，便于定位目录继承问题。
-
-## Composer 与消息流
-
-- `Enter`：提交消息；Agent 运行期间提交的无附件文本会立即追加到当前 run，与桌面端使用相同的 Runtime `steer` 队列。带附件的消息会保留到当前 run 结束后发送，避免丢失附件。
-- `/`：打开由 runtime Tools、已启用 Skills 和内置命令合并而成的 Slash 列表。
-- `Up` / `Down`：移动 Slash、会话、模型、思考等级或文件选择器中的选中项。
-- `Tab`：仅在 Slash 列表打开时补全当前候选。
-- `Esc`：关闭当前选择器、清空 Slash 草稿，或从 Changes 返回 Chat。
-- `↑` / `↓`：逐行翻阅消息；`PageUp` / `PageDown`：每次翻阅 8 行。历史消息按需分页加载，内存中最多保留 160 条，空闲后回收到最近 80 条，避免长会话持续占用内存。
-- `Home` / `End`、`Left` / `Right`、`Backspace` / `Delete`：编辑 composer 草稿。
-- `Ctrl+C`：Agent 运行或等待审批时中止当前 run（若 Agent 卡住未在超时窗口内响应，Runtime 会强制结束该次运行）；运行中再次 `Ctrl+C` 强制退出 TUI；空闲时退出 TUI。
-
-最底部状态栏整体左对齐。会话运行期间，最左侧显示一段彩色能量波，波峰沿固定宽度的柱段来回移动，例如 `▁▂▄▆█▆▄`，不再显示 `Thinking`、`Responding` 等阶段文字；之后依次显示执行模式、模型、思考等级和指标，例如 `▁▂▄▆█▆▄  [full-access]  gpt-5.6-sol  high  ·  88M  ·  cache 79%`。队列和审批位置追加在指标之后，数据按会话隔离。
-
-TUI 默认使用终端真彩色，并在 `TERM` 表明仅支持 256 色时自动降级。可用 `PISPER_TUI_THEME=ansi256` 强制 256 色，或用 `PISPER_TUI_THEME=monochrome` / `NO_COLOR=1` 使用单色模式。设置 `PISPER_TUI_REDUCED_MOTION=1` 会关闭装饰动画并立即显示完整流式文本；翻阅历史消息时也会暂停逐字揭示。
-
-长文本或多行 bracketed paste 会在 composer 中折叠为 `[Pasted text · …]`，但提交给 Agent 的仍是包含原始换行的完整文本。摘要可作为整体移动和删除。
-
-## 内置命令
-
-| 命令 | 作用 |
+| Command | Explanation |
 | :--- | :--- |
-| `/init` | 分析当前项目并创建或完善项目根目录的 `AGENTS.md`。 |
-| `/new` | 在 TUI 启动目录新建空会话；运行期间不可执行。 |
-| `/sessions` | 打开跨所有目录的历史会话选择器；按 `Enter` 恢复，运行期间不可切换。 |
-| `/dir <目录>` | 显式修改当前会话的工作目录；相对路径以当前会话目录为基准，运行期间不可修改。 |
-| `/changes` | 查看 Git 或 SVN 工作区改动；改动页中 `R` 刷新、`C` 提交、`P` 推送 Git、连续按两次 `V` 撤销；SVN 没有 Push。 |
-| `/changes commit <message>` | 使用指定 message 提交当前 Git/SVN 工作区改动。 |
-| `/chat` | 返回 Chat 消息流。 |
-| `/model` | 打开模型选择器并切换当前会话模型；只显示已配置 Provider 的模型，运行期间不可切换。 |
-| `/thinking` | 刷新并打开当前模型支持的思考等级；不支持或加载失败时显示原因并可重试，运行期间不可切换。 |
-| `/provider` | 编辑 Provider 的协议类型、当前生效 Base URL 和掩码 API Key；`/provider <id>` 可直达指定 Provider，`/apikey` 为兼容别名。 |
-| `/web` | 使用已安装的 Web 前端，在默认浏览器打开本机认证配置页。 |
-| `/compact` | 立即摘要较早上下文；仅用于已有可压缩历史的空闲会话。 |
-| `/attach` | 打开当前目录的文件选择器。 |
-| `/mode` | 显示当前执行模式和可用参数；运行期间也可随时调整。 |
-| `/mode read-only` | 只开放低风险分析工具，不允许修改项目。 |
-| `/mode full-access` | 允许本机文件、网络和 Shell 完整访问。 |
-| `/quit` | 退出 TUI。 |
-
-命令候选会根据前缀匹配和本机使用频率排序。`Tab` 只补全，不会执行 Tool；选择内置命令后按 `Enter` 才执行。
-
-`/init` 会让 Agent 先检查项目结构、命令和约定，再生成项目专属的 `AGENTS.md`，而不是写入固定模板。已有文件会在保留有效说明的基础上谨慎更新，且该任务不会修改其他项目文件。`read-only` 模式下不能运行；`full-access` 模式下以当前系统用户权限执行。命令完成后使用 `/new`，可让新会话从启动时加载生成的项目说明。
-
-Agent 创建结构化 Plan 后，TUI 会在消息流和 Composer 之间原位显示步骤、负责人、依赖和状态；窄终端只保留当前项，顶部细分隔显示 `Plan 完成数/总数`。
-
-## 附件
-
-使用以下任一入口打开附件选择器：
-
-- composer 为空时输入 `+`
-- `Ctrl+O`
-- `/attach`
-
-文件选择器操作：
-
-- `Up` / `Down`：选择文件或目录。
-- `Enter` / `Right`：进入目录或添加文件。
-- `Left`：返回上级目录，但不会越过当前目录。
-- `Delete`：移除当前已选附件。
-- `Esc`：关闭选择器并保留 composer 草稿。
-
-安全限制与桌面端一致：最多 8 个文件，单文件不超过 10 MiB，总计不超过 20 MiB；只允许当前目录内的图片、UTF-8 文本/代码和支持的文档。仅当当前模型明确支持图片输入时，图片才会作为视觉输入发送。
-
-## Tool 与 Skill
-
-输入 `/` 后，前缀 `T` 表示 runtime Tool，前缀 `S` 表示已启用且允许模型调用的 Skill。
-
-Tool 示例：
-
-```text
-/read README.md
-/bash npm test
-/web_search Pisper latest release
-/mcp_pencil_get_editor_state_f9837b9b 读取当前 Pencil 画布状态
-```
-
-TUI 只把首个 Slash token 作为结构化 `requestedToolNames` 请求发送给 runtime。Agent 仍负责生成参数和调用 Tool，Slash 选择不会绕过 Tool 开关或当前执行模式；附件仍限制在当前目录内。
-
-Skill 示例：
-
-```text
-/skill:docs-search 查找 Tauri updater 的签名要求
-```
-
-Skill 名称以当前 Slash 列表为准。runtime 会按需加载对应的 `SKILL.md`、脚本和参考资料，Skill 内触发的 Tool 仍走相同权限链。
-
-`read-only` 模式不会开放写入或 Shell 能力；`full-access` 代表用户明确允许以当前系统用户权限完整访问。
-
-## 本地开发
-
-从源码构建 TUI 需要 Rust 1.88 或更高版本。
-
-从源码启动当前目录：
-
-```bash
-npm run tui:dev
-```
-
-指定工作目录：
-
-```bash
-npm run tui:dev -- --cwd /path/to/project
-```
-
-开发版默认运行仓库中的 `runtime/sidecar.mjs`。也可以连接已经运行的隔离 sidecar：
-
-```text
-PISPER_TUI_URL=http://127.0.0.1:<port>
-PISPER_TUI_TOKEN=<desktop token>
-```
-
-或指定 sidecar 可执行文件和 runtime：
-
-```text
-PISPER_SIDECAR_PATH=/path/to/pisper-sidecar
-PISPER_APP_ROOT=/path/to/sidecar-runtime
-```
-
-## 验证
-
-```bash
-npm run tui:test
-npm run tui:check
-cargo clippy --manifest-path src-tui/Cargo.toml --all-targets -- -D warnings
-cargo build --manifest-path src-tui/Cargo.toml --release
-```
+| `pisper` | Start the TUI in the current directory with a new empty conversation. History is not resumed automatically. |
+| `pisper --cwd <directory>` | Start the TUI with a new empty conversation in the specified directory. |
+| `pisper resume` | Open the conversation picker across all workspaces. If no history exists, report it and exit. |
+| `pisper resume --cwd <directory>` | Open the conversation picker from a specified launch directory. A resumed conversation keeps its own saved working directory. |
+| `pisper doctor` | Diagnose Sidecar startup, Runtime authentication, capability catalogs, and the latest conversation directory. |
+| `pisper doctor --cwd <directory>` | Run diagnostics with the specified launch workspace. |
+| `pisper web` | Install or use the Web frontend and open its authenticated local settings page in the default browser. Keep the process running while using the page. |
+| `pisper web --cwd <directory>` | Start the Runtime for a specified directory and open the Web settings page. |
+| `pisper help [COMMAND]` | Show global help. `pisper help web` shows help for the Web subcommand. |
+| `pisper -h` / `pisper --help` | Show command help without starting the Runtime. |
+| `pisper -V` / `pisper --version` | Print the installed TUI version. |
+| `pisper update --check` | Check an npm-installed Pisper for updates without installing them. |
+| `pisper update` | Update an npm-installed Pisper through the active npm registry and verify the components again. |
+
+## Slash Commands
+
+| Command | Explanation |
+| :--- | :--- |
+| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. Existing useful guidance is preserved, and no other project files are changed. |
+| `/new` | Create an empty conversation in the TUI launch directory. Unavailable during an Agent run. |
+| `/sessions` | Open the conversation picker across all directories. Switching is unavailable during an Agent run. |
+| `/dir <directory>` | Change the active conversation's working directory. Relative paths resolve from its current directory. Unavailable during an Agent run. |
+| `/changes` | Open Git or SVN changes. In that view, `R` refreshes, `C` commits, `P` pushes Git, and pressing `V` twice reverts. SVN has no Push operation. |
+| `/changes commit <message>` | Commit the current Git or SVN changes with an explicit message. |
+| `/chat` | Return to the Chat message stream from another view. |
+| `/model` | Open the model picker and switch the active conversation model. Only configured Provider models are listed. Unavailable during an Agent run. |
+| `/thinking` | Refresh and select thinking levels supported by the active model. Unavailable during an Agent run. |
+| `/provider [id]` | Edit a Provider's protocol, effective Base URL, and masked API key. Pass `id` to open a known Provider directly. |
+| `/apikey [id]` | Compatibility alias for `/provider`. |
+| `/web` | Open the authenticated local settings page in the default browser using the installed Web frontend. |
+| `/compact` | Summarize older context immediately. Available only for idle conversations with enough history. |
+| `/attach` | Open the attachment picker rooted at the active conversation directory. |
+| `/mode` | Show the active execution mode and accepted values. The mode can also change during an Agent run. |
+| `/mode read-only` | Expose low-risk analysis tools only and prevent project modifications. |
+| `/mode full-access` | Allow local files, network access, and Shell commands as the current operating-system user. |
+| `/quit` | Exit the TUI. |
+
+## Tool and Skill Commands
+
+| Form | Explanation |
+| :--- | :--- |
+| `/<tool> [request]` | Request a Runtime Tool, for example `/read README.md`, `/bash npm test`, or `/web_search Pisper`. The Agent still generates arguments and calls the Tool; the active execution mode and Tool settings remain enforced. |
+| `/skill:<name> [request]` | Request an enabled Skill, for example `/skill:docs-search find signing requirements`. Runtime resources load on demand, and Tools invoked by the Skill follow the same permission chain. |

package/components/runtime/Pisper_Runtime_Node_0.5.13_darwin_x86_64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOENPeVFhRmpTR1NCWVl2aFpXMjZhVWoxU0pEKzFkbU9tem9BVzYzQWF5OUtIbE1oMmJucDBOUGtvTEdVVUMrYjlJekZuVjltckxQRVFRYmZHTzI1MVFFPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3NDc4NjU4CWZpbGU6UGlzcGVyX1J1bnRpbWVfTm9kZV8wLjUuMTNfZGFyd2luX3g4Nl82NC50YXIuZ3oKRER2R2J3bHNMSkJFK0NSSEZsMFFpd1hjU0FJNEQ5QVJxWkdzS2U2endxclZTYUx5eWZwdlRYTVRhb2R0NlUvVklUbXlJSDk3MDRQS3lPRk8wZ3BzREE9PQo=

package/components/tui/Pisper_TUI_Component_0.5.9_darwin_x86_64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOElHYnplVVliQm92THRJV1RCd1JzdXBXSTdJYlZSMEtsWG5zMTJWaW5WQjBpU2NDelBNekhISDVBVWVvbDUzN1pDNTBFb0dzYit3b1dBbGlaTzRUckFrPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3NDc4MDU2CWZpbGU6UGlzcGVyX1RVSV9Db21wb25lbnRfMC41LjlfZGFyd2luX3g4Nl82NC50YXIuZ3oKRjQ4VC9sdCtqRnhFbi9ZNlZIdzl3ZmoxckRQenFCTSt5ZFFVUTFFdW9tNXQrRUcySitRV3V4WXFvOWNvN0pPTGxwL3U1L3JBeU95c3JPQjdpcGRJQUE9PQo=

package/package.json

@@ -1,57 +1,35 @@
 {
   "name": "pisper",
-  "version": "0.5.13",
-  "description": "Pisper CLI.",
+  "version": "0.5.14-darwin-x64.0",
+  "description": "Pisper signed TUI and Node Runtime bundle for darwin-x64.",
   "license": "MIT",
   "author": {
     "name": "ling-kong-ran",
     "email": "65328093+ling-kong-ran@users.noreply.github.com",
     "url": "https://github.com/ling-kong-ran"
   },
-  "type": "module",
-  "homepage": "https://github.com/ling-kong-ran/pisper#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ling-kong-ran/pisper.git"
   },
-  "bugs": {
-    "url": "https://github.com/ling-kong-ran/pisper/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "bin": {
-    "pisper": "bin/pisper.mjs"
-  },
-  "scripts": {
-    "postinstall": "node lib/postinstall.mjs"
-  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
   "files": [
-    "bin/",
-    "lib/",
-    "web/",
-    "updater.pubkey",
+    "components/",
     "README.md",
-    "README.en.md",
     "LICENSE"
   ],
-  "dependencies": {
-    "@threema/wasm-minisign-verify": "0.1.3",
-    "tar": "7.5.22"
-  },
-  "pisper": {
-    "repository": "ling-kong-ran/pisper",
-    "tuiVersion": "0.5.8",
-    "runtimeVersion": "0.5.12"
-  },
-  "optionalDependencies": {
-    "pisper-binary-win32-x64": "npm:pisper@0.5.13-win32-x64.0",
-    "pisper-binary-darwin-x64": "npm:pisper@0.5.13-darwin-x64.0",
-    "pisper-binary-darwin-arm64": "npm:pisper@0.5.13-darwin-arm64.0",
-    "pisper-binary-linux-x64": "npm:pisper@0.5.13-linux-x64.0"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "pisperBundle": {
+    "target": "darwin_x86_64",
+    "tuiVersion": "0.5.9",
+    "runtimeVersion": "0.5.13"
   }
 }

package/README.en.md

@@ -1,226 +0,0 @@
-# Pisper TUI
-
-![Pisper TUI welcome screen](https://ling-kong-ran.github.io/pisper/shots/cli.png)
-
-![Pisper TUI chat and live activity](https://ling-kong-ran.github.io/pisper/shots/cli-chat.png)
-
-[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper)
-
-[中文指南](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.md)
-
-## Install the Terminal Command
-
-Requires Node.js 20+. Install Pisper, then run `pisper`:
-
-```bash
-npm install -g pisper --progress=true --foreground-scripts
-pisper
-```
-
-Platform packages use the same registry when an npm mirror is configured. `--progress=true` shows npm download progress, while `--foreground-scripts` shows local signature verification and extraction; add `--loglevel=info` only when request and cache details are needed:
-
-```bash
-npm install -g pisper --registry=https://registry.npmmirror.com --progress=true --foreground-scripts
-```
-
-After installing the Pisper desktop app, you can alternatively open **Settings → App updates** to install, repair, or uninstall the `pisper` command. Pisper installs it in a current-user directory and manages the matching `PATH` entry without administrator access.
-
-After installing or uninstalling through the desktop app, restart the terminal host. Fully quit and reopen Windows Terminal, or restart the IDE that owns an integrated terminal.
-
-To build the complete distribution from source:
-
-```bash
-npm run sidecar:sea
-npm run tui:package
-```
-
-The output is written to:
-
-```text
-release/tui/pisper-<version>-<platform>-<arch>/
-├── pisper[.exe]
-├── pisper-sidecar[.exe]
-└── sidecar-runtime/
-```
-
-## Distribution Updates
-
-Check or update an npm installation of Pisper:
-
-```bash
-pisper update --check
-pisper update
-```
-
-The command uses the configured npm registry. Manage desktop updates under **Settings → App updates**.
-
-## Provider and Optional Web Configuration
-
-After entering the TUI for the first time, run `/provider` and choose a Provider to edit its protocol, Base URL, and API key. The Base URL is prefilled with the Runtime's effective address: the official default when there is no override, or the custom address when one is configured. Leaving API Key blank preserves the saved secret. Use `Up`/`Down` or `Tab` to move between fields, `Left`/`Right` to choose a protocol, `Enter` to save, and `Esc` to return to the Provider list or cancel. The API key uses a separate masked input, whitespace is removed when pasting, and the secret never enters the composer, Slash history, or ordinary Runtime configuration responses. For a known Provider you can skip the picker with `/provider <id>`, e.g. `/provider deepseek`; `/apikey` remains a compatible alias.
-
-For complete visual configuration, run:
-
-```bash
-pisper web
-```
-
-This opens local Provider settings in your default browser. Keep the Pisper terminal process running while using the browser. **Save Provider settings** saves the current connection; **Set as default Provider** changes the default model for later sessions.
-
-After Web is installed, run `/web` in the TUI to reopen the settings page. If it is not installed yet, exit and run `pisper web` first.
-
-## Startup and Sessions
-
-Run Pisper from a project directory:
-
-```bash
-pisper
-```
-
-Plain `pisper` always creates an empty conversation. It never restores history automatically. Use `resume` explicitly to open an interactive list containing conversations from every directory; use the arrow keys to select one, press `Enter` to resume, or press `Esc` to exit:
-
-```bash
-pisper resume
-```
-
-When no history exists, `pisper resume` reports that condition and exits without creating a conversation. Resuming uses the conversation's saved working directory without rewriting it to the TUI launch directory. After entering a conversation, `/dir <directory>` explicitly changes its working directory; relative paths resolve from the current conversation directory.
-
-Create a new conversation for another directory:
-
-```bash
-pisper --cwd /path/to/project
-```
-
-Inspect sidecar, authentication, and capability status:
-
-```bash
-pisper doctor
-```
-
-The diagnostic output reports the sidecar connection source, TUI launch directory, sidecar runtime fallback directory, and the latest matching session directory so directory inheritance failures are visible.
-
-## Composer and Message Stream
-
-- `Enter`: submit a message. Plain text submitted during an active run is appended immediately through the same Runtime `steer` queue as the desktop app. Messages with attachments wait until the active run finishes so their attachments are preserved.
-- `/`: open the combined list of runtime Tools, enabled Skills, and built-in commands.
-- `Up` / `Down`: move through Slash, session, model, thinking-level, or file choices.
-- `Tab`: complete the highlighted candidate only while the Slash list is open.
-- `Esc`: close a picker, clear a Slash draft, or return from Changes to Chat.
-- `↑` / `↓`: scroll the conversation one row at a time; `PageUp` / `PageDown`: move eight rows. History loads on demand; the TUI keeps at most 160 messages in memory and evicts back to the latest 80 after an idle period.
-- `Home` / `End`, `Left` / `Right`, `Backspace` / `Delete`: edit the composer draft.
-- `Ctrl+C`: abort the active or approval-blocked run (if the Agent hangs without responding, the Runtime force-settles the run after a timeout); a second `Ctrl+C` while still running force-quits the TUI; exits only while idle.
-
-The bottom status bar is left-aligned. While a session is running, a colorful energy wave appears at the far left, with its peak traveling back and forth across a fixed-width set of bars, for example `▁▂▄▆█▆▄`, instead of phase labels such as `Thinking` or `Responding`. Execution mode, model, thinking level, and metrics follow, for example `▁▂▄▆█▆▄  [full-access]  gpt-5.6-sol  high  ·  88M  ·  cache 79%`. Queue and approval positions follow the metrics. The values remain isolated per conversation.
-
-The TUI uses terminal truecolor by default and automatically falls back when `TERM` advertises only 256 colors. Set `PISPER_TUI_THEME=ansi256` to force the 256-color palette, or use `PISPER_TUI_THEME=monochrome` / `NO_COLOR=1` for monochrome output. `PISPER_TUI_REDUCED_MOTION=1` disables decorative animation and reveals streamed text immediately; scrolling through history also pauses incremental reveal.
-
-Long or multiline bracketed pastes render as a compact `[Pasted text · …]` token. The complete original text, including line breaks, is still submitted to the Agent. The token can be moved across or deleted as one unit.
-
-## Built-in Commands
-
-| Command | Action |
-| :--- | :--- |
-| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. |
-| `/new` | Create an empty conversation in the TUI launch directory; unavailable during a run. |
-| `/sessions` | Open the history picker across every directory; press `Enter` to resume. Unavailable during a run. |
-| `/dir <directory>` | Explicitly change the active conversation directory. Relative paths resolve from its current directory; unavailable during a run. |
-| `/changes` | Inspect Git or SVN changes. In the changes view, `R` refreshes, `C` commits, `P` pushes Git, and `V` twice reverts; SVN has no push operation. |
-| `/changes commit <message>` | Commit current Git/SVN changes with an explicit message. |
-| `/chat` | Return to the Chat message stream. |
-| `/model` | Open the model picker and switch the active session model; only models from configured Providers are listed, and switching is unavailable during a run. |
-| `/thinking` | Refresh and open thinking levels supported by the active model; unsupported/error states explain why and can be retried. Unavailable during a run. |
-| `/provider` | Edit a Provider's protocol, effective Base URL, and masked API key; `/provider <id>` targets a Provider directly and `/apikey` remains a compatible alias. |
-| `/web` | Open the authenticated local settings page in the default browser using the installed Web frontend. |
-| `/compact` | Summarize older context immediately; available only for idle sessions with enough history. |
-| `/attach` | Open the file picker for the current directory. |
-| `/mode` | Show the active execution mode and accepted values; it can be changed during a run. |
-| `/mode read-only` | Expose low-risk analysis tools only. |
-| `/mode full-access` | Allow unrestricted local files, network, and Shell access. |
-| `/quit` | Exit the TUI. |
-
-Candidates are sorted by prefix match and local usage frequency. `Tab` completes a command without executing a Tool; press `Enter` to select a built-in command.
-
-`/init` asks the Agent to inspect the project structure, commands, and conventions before writing repository-specific guidance instead of a fixed template. It carefully preserves useful content in an existing `AGENTS.md` and does not modify other project files. The command is unavailable in `read-only` mode and runs with current-user permissions in `full-access` mode. After it completes, use `/new` to start a session that loads the generated project guidance at startup.
-
-When the Agent creates a structured Plan, the TUI updates its items, owners, dependencies, and statuses in place between the transcript and Composer. Narrow terminals keep only the current item, with `Plan completed/total` in the thin top divider.
-
-## Attachments
-
-Open the attachment picker with any of these controls:
-
-- type `+` while the composer is empty
-- press `Ctrl+O`
-- run `/attach`
-
-File picker controls:
-
-- `Up` / `Down`: select a file or directory.
-- `Enter` / `Right`: enter a directory or add a file.
-- `Left`: move to the parent without leaving the active directory.
-- `Delete`: remove the selected attachment.
-- `Esc`: close the picker while preserving the composer draft.
-
-The desktop attachment boundary is shared by the TUI: up to 8 files, 10 MiB per file, and 20 MiB total. Files must be directory-local images, UTF-8 text/code, or supported documents. Images become visual input only when the active model explicitly supports images.
-
-## Tools and Skills
-
-After typing `/`, `T` marks runtime Tools and `S` marks enabled, model-invocable Skills.
-
-Tool examples:
-
-```text
-/read README.md
-/bash npm test
-/web_search Pisper latest release
-/mcp_pencil_get_editor_state_f9837b9b inspect the current Pencil canvas
-```
-
-The TUI sends the first Slash token through the structured `requestedToolNames` field. The Agent still generates arguments and performs the call. Slash selection never bypasses Tool settings or the active execution mode; attachments remain limited to the current directory.
-
-Skill example:
-
-```text
-/skill:docs-search find the Tauri updater signing requirements
-```
-
-The active Slash list is authoritative for Skill names. The runtime loads the matching `SKILL.md`, scripts, and references on demand. Tools invoked by a Skill follow the same permission chain.
-
-`read-only` does not expose write or Shell capabilities. `full-access` means the user explicitly allows unrestricted access as the current operating-system user.
-
-## Local Development
-
-Building the TUI from source requires Rust 1.88 or newer.
-
-Run from source in the current directory:
-
-```bash
-npm run tui:dev
-```
-
-Choose another directory:
-
-```bash
-npm run tui:dev -- --cwd /path/to/project
-```
-
-Development runs `runtime/sidecar.mjs` by default. To connect an isolated running sidecar:
-
-```text
-PISPER_TUI_URL=http://127.0.0.1:<port>
-PISPER_TUI_TOKEN=<desktop token>
-```
-
-Or specify a sidecar executable and runtime:
-
-```text
-PISPER_SIDECAR_PATH=/path/to/pisper-sidecar
-PISPER_APP_ROOT=/path/to/sidecar-runtime
-```
-
-## Verification
-
-```bash
-npm run tui:test
-npm run tui:check
-cargo clippy --manifest-path src-tui/Cargo.toml --all-targets -- -D warnings
-cargo build --manifest-path src-tui/Cargo.toml --release
-```

package/bin/pisper.mjs

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-
-import { spawn } from 'node:child_process'
-import process from 'node:process'
-import { fileURLToPath } from 'node:url'
-import { ensurePisperInstallation } from '../lib/install.mjs'
-import { handleNpmHelp, handleNpmUpdate } from '../lib/npm-update.mjs'
-
-const frontendRoot = fileURLToPath(new URL('../web', import.meta.url))
-
-try {
-  const arguments_ = process.argv.slice(2)
-  if (!handleNpmHelp(arguments_) && !(await handleNpmUpdate(arguments_))) {
-    const installation = await ensurePisperInstallation()
-    const child = spawn(installation.executable, arguments_, {
-      env: {
-        ...process.env,
-        PISPER_APP_ROOT: installation.appRoot,
-        PISPER_DISTRIBUTION: 'npm',
-        PISPER_FRONTEND_ROOT: frontendRoot,
-        PISPER_RUNTIME_NODE: process.execPath,
-      },
-      stdio: 'inherit',
-      windowsHide: false,
-    })
-
-    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
-      process.on(signal, () => {
-        if (!child.killed) child.kill(signal)
-      })
-    }
-
-    child.once('error', (error) => {
-      console.error(`pisper: failed to start the terminal client: ${error.message}`)
-      process.exitCode = 1
-    })
-    child.once('exit', (code, signal) => {
-      if (signal) {
-        process.kill(process.pid, signal)
-        return
-      }
-      process.exitCode = code ?? 1
-    })
-  }
-} catch (error) {
-  console.error(`pisper: ${error instanceof Error ? error.message : String(error)}`)
-  process.exitCode = 1
-}