AI工作流

Install details

<details> <summary><b>macOS</b> — signed &amp; notarized</summary>

curl -fsSL https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.sh | bash
pairlet pair

Verifies the download against the release's SHA256SUMS, installs under ~/.local (one directory per version), and registers the launchd service so it runs on login and reconnects itself. Homebrew: brew install --cask heypandax/tap/cc-pocket (use the full name; an unrelated cask is also called cc-pocket). </details>

<details> <summary><b>Linux</b> — x86_64 / arm64 daemon</summary>

curl -fsSL https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.sh | bash
pairlet pair

Pulls a self-contained tarball (bundled JRE, no system Java), installs under ~/.local and registers a systemd --user service. Voice transcription uses ffmpeg instead of macOS's afconvert. There is no official Linux desktop app package — build it from source. </details>

<details> <summary><b>Windows</b> — x86_64</summary>

irm https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.ps1 | iex

One command: installs, registers a logon Scheduled Task, and drops straight into pairing. Scoop: scoop bucket add heypandax https://github.com/heypandax/scoop-bucket then scoop install cc-pocket-daemon. </details>

<details> <summary><b>Mainland China mirror</b></summary>

GitHub downloads crawl there, so the installer and release artifacts are mirrored on the relay: curl -fsSL https://pocket.ark-nexus.cc/dl/install.sh | bash (Windows: irm https://pocket.ark-nexus.cc/dl/install.ps1 | iex). Same script, checksum-verified, with automatic fallback to GitHub. The daemon's self-update uses the mirror too. </details>

<details> <summary><b>Updating</b></summary>

pairlet version reports what is running, how it was installed, and the single command that updates this install — offline, and whether or not the daemon is up. The app shows the same under Settings ▸ Versions.

A daemon installed by the one-liner keeps itself current: it checks daily and applies the update in the background. Turn that off with pairlet config --auto-update off and you get a phone notification instead. Homebrew, Scoop and Windows installs never self-apply — update them through their own package manager (brew upgrade --cask heypandax/tap/cc-pocket, scoop update cc-pocket-daemon). The desktop app states it plainly when an update check fails, rather than showing "up to date". </details>

Build from source

Requires JDK 17 (any distribution — the Gradle toolchain downloads one if yours differs), the Android SDK (ANDROID_HOME or local.properties; the Android modules are configured even for JVM-only tasks), and at least one installed, logged-in agent CLI. To build the mobile app, copy the committed Firebase placeholder once (a real Firebase project is only needed for push/analytics):

cp mobile/composeApp/google-services.json.template mobile/composeApp/google-services.json

Local single-machine (no relay), for development:

./gradlew :protocol:check                         # protocol contract test
./gradlew :daemon:run --args="run"                # daemon — local WebSocket on 127.0.0.1:8765
./gradlew :daemon:run --args="test-client"        # drive it against a real agent CLI

Through the relay (off-LAN), the real product path:

./gradlew :daemon:installDist
daemon/build/install/cc-pocket-daemon/bin/cc-pocket-daemon run --relay wss://<your-relay>
daemon/build/install/cc-pocket-daemon/bin/pairlet pair    # in another terminal

Build the app: Android via ./gradlew :mobile:composeApp:assembleDebug; iOS via iosApp/iosApp.xcodeproj (Xcode — first copy iosApp/iosApp/GoogleService-Info.plist.template to GoogleService-Info.plist next to it). Desktop (including Linux) via ./gradlew :mobile:composeApp:packageDistributionForCurrentOS. On-device iOS install: docs/ios-device.md.

Quick start

1 · Get the app — App Store (iPhone · iPad) · TestFlight beta · Android APK. Prefer a computer? See the Desktop app.

2 · Install the daemon on the machine that runs your agent CLI — any supported one, not Claude specifically:

curl -fsSL https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.sh | bash   # macOS · Linux
irm https://raw.githubusercontent.com/heypandax/pairlet/main/scripts/install.ps1 | iex          # Windows

3 · Pair — run pairlet pair, then scan the QR it prints (or type the 6-digit code) in the app. You are connected end-to-end.

pairlet is the short command; cc-pocket-daemon still supports the same subcommands. If an older installation has no pairlet command yet, keep using cc-pocket-daemon until you update through its original installer or package manager.

Package managers, mirrors, updates and per-platform notes: Install details.