[English](README.en.md) | 中文

**多端一体化设计，随时随地切换多客户端形态，操纵你电脑上所有的 agent（已接入 Claude Code 与 Codex，后续还有更多）** 客户端只是入口，**任务始终在电脑上执行**——断连不影响任务，重连自动续上；同一份会话，手机和桌面可以接着来。

快速开始

1. 装 daemon

前置：**Node `~24`**，以及本机已装并登录的 agent CLI——Claude Code（`claude auth login`）或 Codex，装哪个就能用哪个。

npm install -g @noresign/paboot      # 全局命令名是 paboot

paboot  # 工作目录默认取命令启动的目录

• token 持久化在 ~/.paboot/token，删掉即轮换；也可以用 --token 自己指定
• 完整参数、配置项与 HTTP/SSE 接口见 daemon/README.md

2. Android 客户端

**(1) [release](https://github.com/noResign/paboot/releases) 页面直接下载apk包**

**(2) 自行编译运行**

用 Android Studio 打开 `android/` 选 flavor 后直接 Run。命令行等价于：

cd android
./gradlew :app:assembleAlphaDebug

两个通道：`alphaDebug`（测试）与 `prodDebug`（正式）；正式签名需要 `android/keystore.properties`。模块划分与签名说明见 [android/README.md](android/README.md)。

3. 操作步骤

1. 打开 App，填 daemon 地址（就是启动时打印的那个 LAN 地址）和 token，连接
2. 新建会话 → 选工作区目录 → 发一句话
3. agent 在电脑上干活，手机上看流式输出；需要你确认的工具调用会弹审批卡
4. 在「设置 → 通知」开启「后台任务提醒」并授予系统通知权限；离开会话页后，需要审批或任务完成、失败、取消时会收到通知，点击直达对应会话
5. 想走就走——任务在电脑上继续跑，回来重连自动续上

4. 手机电脑不在同一个局域网（可选）

daemon 默认监听局域网，公网连接有以下两种方法：

**(1) SSH 中转**

适合自用，需要一台公网服务器，在**跑 daemon 的电脑**上执行：

ssh -N -R 0.0.0.0:4788:localhost:4780 user@your-server

然后手机连 `http://your-server:4788`，4788端口为服务器端口，可自定义选择。但要注意：**SSH 只加密了「电脑 → 服务器」这一段，手机到服务器 那一跳仍是明文 HTTP**，token 在这段上等于裸奔——所以这条路只适合自己临时用。

• -R 默认只在服务器的 loopback 上监听，手机连不上；需要在服务器 /etc/ssh/sshd_config 里设 GatewayPorts clientspecified
• 隧道断了不会自愈，做成 systemd 服务常驻或用 `a