apwcli-pairlisted
Install: claude install-skill soulmachine/skills
# apwcli-pair
apwcli's daemon pairs with Apple's password helper once per login session. Pairing shows a
6-digit PIN in a macOS window, "Verification Code", that a person normally reads and types. This
script reads it through Accessibility and submits it, so no one needs to be at the screen.
## Commands
```bash
# on the Mac itself
~/.agents/skills/apwcli-pair/scripts/apwcli-pair
# another fleet Mac, from anywhere
ssh -o BatchMode=yes -o ConnectTimeout=15 <host> 'zsh -lc ~/.agents/skills/apwcli-pair/scripts/apwcli-pair'
```
A paired host prints `already paired` and exits 0, so the command is safe to repeat. Check the
result with `apwcli pw get github.com`, not with `apwcli daemon status`: its `pairing` line reads
"not paired" for a few seconds while a challenge is open even when the session works.
| Exit | Meaning | Do |
|---|---|---|
| 0 | `paired` or `already paired` | carry on |
| 1 | the helper rejected the PIN | run it again; a second failure means a stale window, so `apwcli daemon restart` first |
| 2 | apwcli error (no daemon, no browser) | run `apwcli doctor` on that host |
| 3 | no PIN visible within 15 s | see preconditions; then the fallback |
## Preconditions
- apwcli installed: the `apwcli` role of macbook-provision does it (`uv tool install apwcli`),
with Google Chrome present for the daemon's headless browser.
- The Mac is logged in and unlocked. A locked screen hides windows from Accessibility.
- The process that runs the script has Accessibility. Ove