Installation

Requirements

Requirement	Details
OS	macOS (Apple Silicon / Intel), Linux (x86_64 / arm64), Windows (x86_64)
Git	Required for pb skills new
Node.js	Optional. Required only for skills installed via npx
Network	Internet access to GitHub (for install and update)

Install

macOS

curl -fsSL https://get.phonebase.cloud | sh

Linux

curl -fsSL https://get.phonebase.cloud | sh

Windows

# Download from GitHub Releases:
# https://github.com/phonebase-cloud/phonebase-cli/releases
# Rename to pb.exe and add to PATH

Expected output:

  PhoneBase CLI Installer
  ───────────────────────

  Version:    v1.0.5
  Platform:   macos-arm64
  Install to: /usr/local/bin

  Downloading...
  ✓ Installed: /usr/local/bin/pb

  Get started:

    pb login          # Login via browser
    pb apikey <key>   # Or set API Key
    pb devices        # List devices

Manual Install

Download the binary from GitHub Releases, make it executable, and move to your PATH.

Available binaries:

• phonebase-v{version}-macos-arm64 — macOS Apple Silicon (M1/M2/M3/M4)
• phonebase-v{version}-macos-x64 — macOS Intel
• phonebase-v{version}-linux-x64 — Linux x86_64
• phonebase-v{version}-linux-arm64 — Linux ARM64
• phonebase-v{version}-windows-x64.exe — Windows x86_64

chmod +x phonebase-v*
sudo mv phonebase-v*-macos-arm64 /usr/local/bin/pb

Verify

pb --version

Expected output:

PhoneBase CLI 1.0.5

Upgrade

pb update

Expected output (when a new version is available):

Current version: 1.0.3

✓ Latest version: 1.0.5 (2026-04-09  3.2 MB  macos-arm64)

  Changelog:
    ...

Update? (Y/n) Y

Downloading phonebase-v1.0.5-macos-arm64...

Update successful! Current version: 1.0.5

When already up to date:

Current version: 1.0.5

Current version: 1.0.5, already up to date

Uninstall

macOS / Linux

sudo rm $(which pb)
rm -rf ~/.phonebase/

Windows

# Delete pb.exe from your PATH directory
rmdir /s /q %USERPROFILE%\.phonebase

Troubleshooting

"command not found: pb"

The pb binary is not in your system PATH.

# Check where pb was installed
which pb

# If not found, move it to a directory in your PATH
sudo mv ./pb /usr/local/bin/pb

Permission denied

chmod +x /usr/local/bin/pb

On macOS, if you see a security warning ("cannot be opened because the developer cannot be verified"):

xattr -d com.apple.quarantine /usr/local/bin/pb

Proxy / Corporate Network

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080