pinchtab

环境要求

• macOS 或 Linux 系统（安装脚本与 Homebrew 面向这两类系统）
• 已安装 Node.js / npm（仅选择 npm 安装方式时需要）
• 已安装 Homebrew（仅选择 brew 安装方式时需要）
• 本地可运行无头 Chrome（daemon 启动会拉起默认无头 Chrome 实例）
• 可访问 pinchtab.com 与 GitHub Releases 的网络

安装与启动步骤

1. 1安装 PinchTab

   任选一种方式安装：官方脚本、Homebrew（brew install pinchtab/tap/pinchtab）或 npm（npm install -g pinchtab），三种选一种即可。

   curl -fsSL https://pinchtab.com/install.sh | bash

   复制

2. 2安装并启动守护进程

   把服务装成用户级守护进程，同时拉起一个默认无头 Chrome 实例，之后浏览器控制面会在后台常驻。

   pinchtab daemon install

   复制

3. 3接管本地浏览器服务

   让 agent 或工具连接到本地地址 http://localhost:9867，由 PinchTab 作为本地浏览器服务使用。

4. 4启动首个实例

   调用 /instances/start 接口，用 profileId 区分实例身份，mode 指定为 headless 无头模式。

   curl -s -X POST http://localhost:9867/instances/start -H "Content-Type: application/json" -d '{"profileId":"alice","mode":"headless"}'

   复制

5. 5并行启动多实例

   对同一接口换用不同 profileId（如 bob）即可并行运行多个浏览器实例，互不干扰。

   curl -s -X POST http://localhost:9867/instances/start -H "Content-Type: application/json" -d '{"profileId":"bob","mode":"headless"}'

   复制

6. 6可选：zsh 补全

   把生成的补全脚本写入 zsh 的 fpath 目录，方便日常敲 pinchtab 命令。

   pinchtab completion zsh > "${fpath[1]}/_pinchtab"

   复制

关键配置

如何确认成功

守护进程启动后本地 http://localhost:9867 可访问，向 /instances/start 发请求能正常返回实例信息即成功。

常见问题

注意事项

• 日常使用推荐装成用户级守护进程，agent 可复用后台同一个浏览器控制面
• 多数用户不必直接接触 pinchtab bridge，仅在需要本地交互菜单时才用 pinchtab 命令
• 多实例务必使用不同 profileId，避免实例身份冲突
• curl 命令中的 JSON 请保持 Content-Type: application/json 请求头