Pairlet CLI
A phone as a remote for Claude Code, Codex and OpenCode: watch the agent work and approve actions while it stays on your PC.
- 153 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The daemon accepts commands and permission answers over the network for agents that run commands and write files on your computer.
- An "allow" tap on the phone triggers agent actions on the computer, and encryption is not a sandbox.
- Installation uses a script that is downloaded and run through `curl`.
Install
- Works in
Manual install
curl -fsSL https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.sh | bashFor macOS and Linux: verifies checksums, installs the daemon under `~/.local` and registers a service. Run `pairlet pair` afterwards.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The daemon accepts commands and permission answers over the network for agents that run commands and write files on your computer.
- An "allow" tap on the phone triggers agent actions on the computer, and encryption is not a sandbox.
- Installation uses a script that is downloaded and run through `curl`.
This is third-party code. Review the repository files before installing.
What it does
Pairlet is a local control plane for command-line coding agents. The `pairlet` daemon on your computer runs the agent (Claude Code, OpenAI Codex, OpenCode, Kimi Code, ZCode or DeepSeek) against your own checkout, while an app on a phone, tablet or another computer shows progress, answers permission prompts, continues the same session and lists changed files with line-level diffs. Traffic between the app and the daemon is end-to-end encrypted and travels through a relay that forwards only ciphertext: there is no Pairlet account and no content logging. The daemon dials out to the relay, so no inbound ports are needed. The `pairlet pair` command creates the pairing: the app scans a QR code or accepts a six-digit code.
Who it is for. Developers whose agents run for a long time: you can step away from the computer and still answer a permission prompt from your phone in time.
Good fit when
- The agent waits for a command approval and you left your desk: the prompt reaches the phone and answering takes seconds.
- A long task starts at home and is checked from a tablet on the way.
- A session is taken over from the phone in place, without forking a new conversation.
- You want to see which files the agent changed and read line-level diffs.
- One person runs several agents on different projects and filters sessions by agent.
Not a fit when
- The agent runs in the cloud: Pairlet controls only an agent on your own computer.
- You work in OpenCode and want access modes: it has no approval protocol and sessions run with full access.
- Encryption must pass a third-party audit: the custom Noise-style channel has not had an independent review yet.
Example request
Continue the Claude Code session from the phone and show which files it changed.Limitations
The agent runs with your own operating-system permissions, and end-to-end encryption is not a sandbox. Capabilities depend on the agent: OpenCode has no approvals (always full access) and no changed-files list; Kimi Code is still Preview; DeepSeek has no usage accounting. First pairing relies on the relay not being compromised, so compare device fingerprints afterwards with `pairlet devices`. The iOS and Android apps come from the stores or the releases page, and there is no official Linux desktop app package. The license is MIT.
How to disable. Stop the daemon service (launchd on macOS, `systemd --user` on Linux, a scheduled task on Windows) and delete the install directory under `~/.local`. Device pairings can be revoked and expire on their own.
FAQ
How do I install Pairlet?
Install the app on a phone or computer and the daemon on the machine running the agent: `curl -fsSL https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.sh | bash` on macOS and Linux or `irm https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.ps1 | iex` on Windows. Then run `pairlet pair`.
How is Pairlet related to CC Pocket?
Pairlet is the former name of the author's own project, CC Pocket (`cc-pocket`). The `cc-pocket-daemon` command supports the same subcommands. Another author runs a project of the same name and has a separate card in the catalog.
Which agents does Pairlet support?
Claude Code, OpenAI Codex, OpenCode, Kimi Code (Preview), ZCode and DeepSeek. Their capabilities differ: the project publishes the matrix itself, and OpenCode has no approvals.
Can I do without the relay?
Partly. The desktop app on the same computer connects to the daemon directly. A phone on the same network needs `pairlet config --direct-connect lan` and a daemon restart. The relay stays as the fallback from anywhere.
Can the relay see session content?
No. The relay forwards ciphertext and holds no messages or private keys. P-256 ECDH, HKDF and AES-256-GCM run between the app and the daemon.
Discussion
No questions or reviews yet.
Related
CLI toolspikiloom runs Claude Code, Codex and Gemini from one web dashboard and chat apps so you can steer agents from a phone.
A bridge server and mobile app that opens your computer's Claude Code and Codex sessions as a chat on your phone
A teaching terminal coding agent in Python, built as a "nanoGPT for agents": read it, take it apart and fork it
A compact OpenClaw alternative: a personal assistant on Claude Agent SDK with agents in isolated containers and messengers added via skills
A local control panel for coding agents: it runs Claude Code and Codex, keeps a task queue and merges verified work into main.
CLI that runs Claude Code, Codex and other terminal AI tools behind encrypted remote access from a phone or tablet.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Pairlet (this card) | no | 153 | |
| CC Pocket | no | 1,093 | a Node.js bridge for Claude Code and Codex by another author; Pairlet drives six agents through a Kotlin daemon and an encrypting relay |
| OpenCode Telegram Bot | no | 1,339 | controls only OpenCode through a Telegram bot; Pairlet is its own app for six agents with action approval |
README in short
The project consists of a shared protocol, a daemon, a relay and a mobile app on Kotlin Multiplatform with Compose. The relay is hosted by default, but you can run your own.