# Pairlet User Manual — full AI index

Canonical source: https://pairlet.org/manual/
Content verified: 2026-07-25

Use the matching article URL as the citation. Do not invent steps that are absent from the article.

## Install and pair a computer (en)

URL: https://pairlet.org/manual/en/install-and-pair/

Install the daemon on the computer that runs your coding agent, run pairlet pair , then scan the QR code in the Pairlet app or enter its 6-digit code.

install Install the daemon Run the command for your operating system on the computer where Claude Code, Codex, or OpenCode is installed. macOS or Linux The installer verifies the release, installs the daemon, and registers the login service. curl -fsSL https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.sh | bash Windows Run PowerShell as your normal user. The installer registers a logon Scheduled Task. irm https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.ps1 | iex pair Pair the app Create a one-time pairing code Run this on the computer. It prints both a QR code and a 6-digit fallback code. pairlet pair Scan or type the code Open CC Pairlet, choose Add computer, and scan the QR. If the camera is unavailable, type the six digits. Open a project After the computer shows online, choose a project folder and start or resume a session. pairlet is the short command; older installations can still use cc-pocket-daemon with the same subcommands. Pairing is device-to-device. Pairlet does not create a user account, and the daemon dials out—no inbound internet port is required.

## 安装并配对电脑 (zh)

URL: https://pairlet.org/manual/zh/install-and-pair/

在运行编码 Agent 的电脑上安装 daemon，执行 pairlet pair ，再用 Pairlet App 扫描二维码或输入 6 位配对码。

install 安装 daemon 在已经安装 Claude Code、Codex 或 OpenCode 的电脑上，执行对应系统的命令。 macOS 或 Linux 安装器会校验发行包、安装 daemon，并注册登录后自动启动的服务。 curl -fsSL https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.sh | bash Windows 用普通用户打开 PowerShell。安装器会注册登录时运行的计划任务。 irm https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.ps1 | iex pair 配对 App 生成一次性配对码 在电脑上执行。命令会同时打印二维码和 6 位备用配对码。 pairlet pair 扫码或输入配对码 打开 CC Pairlet，选择“添加电脑”并扫描二维码；相机不可用时可输入 6 位数字。 打开项目 电脑显示在线后，选择项目文件夹，开始新会话或恢复现有会话。 pairlet 是简短命令，旧安装仍可使用 cc-pocket-daemon，子命令相同。配对发生在设备之间。Pairlet 不创建用户账号；daemon 主动向外连接，无需开放公网入站端口。

## Review files changed in a session (en)

URL: https://pairlet.org/manual/en/review-changed-files/

Open the live session, tap ⋯ → Changed files , choose a file, then switch between its Diff and File views.

open Open the changed-file list Open the live session Choose the session whose work you want to review. The list is scoped to that session. Open Quick actions Tap ⋯ in the top-right, then choose Changed files . Choose a file Each row identifies the changed path and, when available, its added and removed line counts. inspect Inspect the result Diff shows added and removed lines grouped by hunk. File shows the resulting file content; binary files may only offer the file view. Opening this screen is read-only. It does not approve a pending tool request or edit the file. If no files are listed, the agent may not have changed a file in this session yet, or the connected daemon may be too old to provide line-level diffs.

## 查看本次会话改过的文件 (zh)

URL: https://pairlet.org/manual/zh/review-changed-files/

打开进行中的会话，点击 ⋯ → 改动文件 ，选择文件，再在 Diff 与文件原文之间切换。

open 打开改动文件列表 打开进行中的会话 选择需要核对工作的会话；改动文件列表只对应这个会话。 打开快捷操作 点击右上角的 ⋯ ，再选择 改动文件 。 选择文件 每行会显示变更路径；数据可用时，也会显示新增与删除行数。 inspect 核对结果 Diff 按区块展示新增行与删除行。 文件 展示变更后的内容；二进制文件可能只提供文件视图。 打开此页面是只读操作，不会批准待处理的工具请求，也不会编辑文件。 如果列表为空，可能是 Agent 尚未在本次会话修改文件，或当前 daemon 版本过旧，无法提供逐行 diff。

## Schedule a prompt for later (en)

URL: https://pairlet.org/manual/en/schedule-a-prompt/

Type the prompt, long-press Send , choose 30m, 1h, 3h, 8h , or Custom time… , then confirm. Turn on Repeat daily for a recurring task.

steps Schedule the prompt Write the prompt Open the target session and type the message exactly as you want the agent to receive it. Long-press Send A normal tap still sends immediately. Press and hold Send to open the scheduling sheet. Choose a time Pick 30m, 1h, 3h, 8h, or Custom time…. Optionally turn on Repeat daily. Confirm The button shows the resolved time. Tap Schedule for <time>, or Schedule daily at <time>. manage Manage scheduled tasks Open Settings → Scheduled tasks to see the next run, whether the task resumes a session or starts a new one, the last failure reason, and the Remove action. The paired computer’s daemon stores and runs the task. That computer must be online at the scheduled time. troubleshooting Troubleshooting Holding Send does nothing Make sure the composer contains a message. If Settings says the daemon is too old, update the computer first. The task did not run Open Settings → Scheduled tasks. A failed row shows the last failure reason. Confirm that the paired computer is online.

## 预约稍后发送提示词 (zh)

URL: https://pairlet.org/manual/zh/schedule-a-prompt/

输入提示词后长按 发送 ，选择 30 分钟、1 小时、3 小时、8 小时 或 自定义时间… ，再确认。需要每天执行时打开 每天重复 。

steps 预约提示词 输入提示词 打开目标会话，按希望 Agent 收到的样子输入完整消息。 长按发送 普通点击仍会立即发送；按住发送键，打开预约面板。 选择时间 选择 30 分钟、1 小时、3 小时、8 小时或自定义时间；也可以打开每天重复。 确认预约 按钮会显示换算后的具体时间。点击“<时间> 发送”或“每天 <时间> 发送”。 manage 管理定时任务 打开 设置 → 定时任务 ，可以查看下次执行时间、任务是接续会话还是新建会话、上次失败原因，以及删除操作。 任务由已配对电脑上的 daemon 保存并执行；到达预约时间时，这台电脑必须在线。 troubleshooting 故障排查 长按发送没有反应 确认输入框中已有消息。如果设置页提示 daemon 版本过旧，请先更新电脑端。 任务没有执行 打开“设置 → 定时任务”。失败条目会显示最近失败原因；同时确认已配对电脑在线。

## How Whisper dictation handles audio (en)

URL: https://pairlet.org/manual/en/whisper-dictation-privacy/

With Whisper enabled, the paired computer’s daemon reassembles the recording and runs local whisper.cpp . It does not log audio or transcript content. Temporary-file deletion is best-effort, so the implementation does not promise that cleanup can never fail.

flow Where transcription runs The app base64-encodes the completed recording and sends indexed AudioChunk frames to the paired computer. The daemon rejoins and decodes those chunks, then invokes the computer’s local whisper.cpp pipeline. The transcription result returns to the device that sent the recording; it is not injected into a separate agent process. logs-and-files Logs and temporary files The implementation does not write audio bytes or transcript text to daemon logs. The normal CLI path logs the exit code and duration. If transcription throws, the error path logs the exception type and up to 120 characters of its message. Audio and intermediate output live under a temporary directory. A finally block attempts recursive deletion after the run. Deletion errors are swallowed, so cleanup is best-effort—not an absolute guarantee that no temporary file can remain after every failure.

## Whisper 语音转写如何处理录音 (zh)

URL: https://pairlet.org/manual/zh/whisper-dictation-privacy/

开启 Whisper 后，已配对电脑上的 daemon 会重组录音并运行本地 whisper.cpp 。实现不会记录音频或转写正文；临时文件采用尽力删除，因此不能承诺清理绝不会失败。

flow 转写在哪里运行 App 会把完整录音进行 Base64 编码，再以带序号的 AudioChunk 分片发送给已配对电脑。 daemon 重组并解码这些分片，然后调用电脑本地的 whisper.cpp 流程。 转写结果只返回给发送录音的设备，不会注入另一个 Agent 进程。 logs-and-files 日志与临时文件 实现不会把音频字节或转写正文写入 daemon 日志。 CLI 正常路径记录退出码和耗时；如果转写抛出异常，错误路径会记录异常类型和最多 120 个字符的异常消息。 音频与中间产物位于临时目录；运行结束后， finally 会尝试递归删除。 删除错误会被忽略，因此这里只能承诺“尽力清理”，不能保证所有异常情况下都绝对没有临时文件残留。

## Take over a terminal session without forking (en)

URL: https://pairlet.org/manual/en/take-over-a-terminal-session/

Open the terminal session in Pairlet and tap Continue here . It resumes in place when the terminal is idle; it forks only while the terminal is still writing, which prevents two writers from corrupting one transcript.

observe Observe first Terminal-owned sessions appear in the project’s session list. Opening one starts in read-only observation, so Pairlet can stream its output without becoming a second writer. take-over Continue from Pairlet Wait for the terminal turn to settle If the terminal is still actively writing, let it finish unless you intentionally want a safe fork. Tap Continue here Pairlet resumes the same session in place when it is safe to do so. Keep working Prompts, approvals, interrupts, and live output now behave like any other Pairlet-controlled session. For Claude Code, you can later return to the computer and use claude --resume to pick the session up again.

## 无分叉接管终端会话 (zh)

URL: https://pairlet.org/manual/zh/take-over-a-terminal-session/

在 Pairlet 中打开终端会话并点击 Continue here 。终端空闲时会原地恢复；只有终端仍在写入时才分叉，避免两个写入者破坏同一份记录。

observe 先旁观 终端拥有的会话会出现在项目会话列表中。打开后先进入只读旁观，Pairlet 可以流式显示输出，但不会成为第二个写入者。 take-over 从 Pairlet 继续 等待终端本轮结束 如果终端仍在持续写入，除非你确实需要安全分叉，否则先让它完成。 点击 Continue here 条件安全时，Pairlet 会在同一个会话中原地接续。 继续工作 之后的提示词、审批、打断和实时输出，与普通 Pairlet 会话一致。 对于 Claude Code，之后回到电脑可用 claude --resume 再次接起该会话。

## Approve work from another device (en)

URL: https://pairlet.org/manual/en/approve-from-another-computer/

When the agent asks for permission, open the waiting session, read the exact command or file action, then choose Allow or Deny . If you do not answer, the request times out to a safe deny.

review Review the request Open the waiting session A waiting approval is visible in the session and in the fleet view when multiple computers are paired. Read the action Check the tool name, command, path, and any warning styling. Do not approve an action you do not understand. Allow or deny Allow continues the agent turn. Deny sends the refusal back to the agent so it can adjust. modes Choose the right execution mode Ask each step keeps command and file actions behind approval. Auto-edit allows file edits but still asks before commands. Plan asks the agent to plan before acting. Full auto grants broad autonomy and should only be used when you accept the risk.

## 从另一台设备审批操作 (zh)

URL: https://pairlet.org/manual/zh/approve-from-another-computer/

Agent 请求权限时，打开等待中的会话，核对具体命令或文件操作，再选择 允许 或 拒绝 。如果不处理，请求会超时并安全拒绝。

review 核对请求 打开等待中的会话 待审批项会显示在会话中；配对多台电脑时，也会出现在总览中。 阅读操作内容 检查工具名、命令、路径和警告样式。不要批准自己不理解的操作。 允许或拒绝 允许后 Agent 继续运行；拒绝会把结果返回给 Agent，让它调整方案。 modes 选择合适的执行模式 每步都问 ：命令和文件操作都需要审批。 自动改文件 ：文件编辑自动放行，命令仍会询问。 计划模式 ：先要求 Agent 制定计划。 全自动 ：授予较大自主权，仅在你接受风险时使用。

## Choose an agent and model (en)

URL: https://pairlet.org/manual/en/choose-agent-and-model/

Choose the agent when the session starts. A session stays bound to that backend; models can be changed within the choices that backend and your gateway expose.

agent Choose the backend at session start Claude Code supports Claude permission modes and model aliases. Codex uses a Cautious, Balanced, Autonomous, or Full auto preset mapped to approval policy and sandbox settings. OpenCode runs full access because its run command has no interactive approval protocol. You cannot switch a live session from one agent backend to another. Start a new session when you need a different backend. model Choose a model Use the model picker in a session. If Claude Code is routed through an Anthropic-compatible gateway, custom ids and saved gateway presets are passed to that local CLI; the gateway decides which model the id reaches.

## 选择 Agent 与模型 (zh)

URL: https://pairlet.org/manual/zh/choose-agent-and-model/

在创建会话时选择 Agent。一个会话从头到尾绑定同一个后端；模型可在该后端和你的网关实际提供的选项中切换。

agent 创建会话时选择后端 Claude Code 支持 Claude 权限模式与模型别名。 Codex 使用 Cautious、Balanced、Autonomous 或 Full auto 预设，映射到审批策略与沙箱设置。 OpenCode 的运行命令没有交互式审批协议，因此始终是完全访问。 不能把进行中的会话从一个 Agent 后端切换到另一个；需要换后端时，请新建会话。 model 选择模型 在会话中使用模型选择器。如果 Claude Code 通过 Anthropic 兼容网关路由，自定义 ID 和已保存的网关预设会传给本机 CLI；这个 ID 最终对应哪个模型，由网关决定。

## What a separate Claude login shares (en)

URL: https://pairlet.org/manual/en/separate-claude-login/

When the daemon reports credential isolation as enabled, only Claude credentials are private to it. Session history, CLAUDE.md , skills, plugins, settings, and MCP configuration remain shared. If setup fails, the daemon warns and runs without isolation.

isolated What is isolated After the daemon successfully prepares its isolated CLAUDE_CONFIG_DIR and reports credential isolation as enabled, only the credential store is private to the daemon. Logging in or out from Pairlet then changes the daemon’s Claude credentials without replacing the terminal Claude login. shared What stays shared Session history under projects, so resuming from another device keeps working. CLAUDE.md , settings, agents, commands, skills, plugins, and todos. MCP server configuration and project trust stored in .claude.json . This is credential isolation, not a separate Claude workspace or multi-profile session store. fallback If isolation setup fails The daemon prints a warning and continues without credential isolation. In that state, do not assume Pairlet sign-in or sign-out is independent of the terminal Claude login; fix the daemon setup before switching accounts.

## 独立 Claude 登录会共享什么 (zh)

URL: https://pairlet.org/manual/zh/separate-claude-login/

当 daemon 报告凭据隔离已开启时，只有 Claude 凭据归它独立使用；会话历史、 CLAUDE.md 、skills、plugins、settings 和 MCP 配置仍然共享。若准备失败，daemon 会告警并以未隔离模式运行。

isolated 哪些内容会隔离 daemon 成功准备独立的 CLAUDE_CONFIG_DIR 并报告凭据隔离已开启后，只有凭据存储归 daemon 独立使用。此时在 Pairlet 中登录或退出，只会改变 daemon 的 Claude 凭据，不会替换终端中 Claude 的登录状态。 shared 哪些内容仍然共享 会话历史 （projects），因此恢复会话和跨设备接续仍然有效。 CLAUDE.md 、settings、agents、commands、skills、plugins 和 todos。 保存在 .claude.json 中的 MCP 服务器配置 与项目信任信息。 这是“凭据隔离”，不是另建一套 Claude 工作区或多账号会话库。 fallback 如果隔离准备失败 daemon 会输出告警并继续以未隔离模式运行。此时不要假定 Pairlet 的登录或退出与终端 Claude 登录相互独立；请先修复 daemon 的隔离准备问题，再切换账号。

## Fix an offline computer (en)

URL: https://pairlet.org/manual/en/fix-offline-computer/

On the offline computer, run pairlet status . If the daemon is stopped or cannot reach the relay, restore its service or network first. Re-pair only when the app says the pairing is invalid.

status Check the daemon Inspect status The status command checks the local daemon process and its relay link. pairlet status Restore the service or network Wake the computer, confirm it has internet access, and let the installed login service restart the daemon. Return to Pairlet The app reconnects automatically when the existing pairing is still valid. pairing Re-pair only when required If the app explicitly says the pairing is invalid or the device was revoked, run pairlet pair and add the computer again. A normal temporary offline state does not require re-pairing.

## 修复离线电脑 (zh)

URL: https://pairlet.org/manual/zh/fix-offline-computer/

在离线电脑上执行 pairlet status 。如果 daemon 已停止或无法连接中继，先恢复服务或网络；只有 App 明确提示配对失效时才重新配对。

status 检查 daemon 查看状态 状态命令会检查本机 daemon 进程以及它与中继的连接。 pairlet status 恢复服务或网络 唤醒电脑、确认网络可用，并让已安装的登录服务重新拉起 daemon。 返回 Pairlet 只要原有配对仍有效，App 会自动重新连接。 pairing 仅在必要时重新配对 如果 App 明确提示配对无效或设备已被撤销，执行 pairlet pair 并重新添加电脑。普通的暂时离线不需要重新配对。

## Update the daemon (en)

URL: https://pairlet.org/manual/en/update-daemon/

Run pairlet update . If the installation is managed by Homebrew or Scoop, use that package manager instead.

update Choose the matching update path Built-in installer Use this for installations created by the official shell or PowerShell installer. pairlet update Homebrew on macOS Use the full cask name; Homebrew has an unrelated cask with the same short name. brew upgrade --cask heypandax/tap/cc-pocket Scoop on Windows Use this when Scoop owns the daemon installation. scoop update cc-pocket-daemon verify Verify the result Run pairlet status , then return to Pairlet. Existing valid device pairings reconnect automatically after the daemon restarts.

## 更新 daemon (zh)

URL: https://pairlet.org/manual/zh/update-daemon/

执行 pairlet update 。如果安装由 Homebrew 或 Scoop 管理，请改用对应包管理器。

update 选择对应更新方式 内置安装器 通过官方 shell 或 PowerShell 安装脚本安装时，使用此命令。 pairlet update macOS 的 Homebrew 必须使用完整 cask 名；Homebrew 官方仓中存在一个无关的同名 cask。 brew upgrade --cask heypandax/tap/cc-pocket Windows 的 Scoop daemon 由 Scoop 安装时使用此命令。 scoop update cc-pocket-daemon verify 确认更新结果 执行 pairlet status ，再返回 Pairlet。daemon 重启后，仍有效的设备配对会自动重新连接。
