pinq

Pair-In Quick CLI for receiving text and files from the mobile PWA via WebRTC DataChannels.

Installation

# Install from npm (global)
npm i -g pinq-cli

# or run from this repo without installing globally
pnpm --filter pinq-cli build
node apps/cli/dist/index.js receive ABC123

Usage

pinq receive <CODE> [options]

Examples:

# Receive into ~/Downloads
pinq receive ABC123

# Choose custom directory and require confirmation for files
pinq receive ABC123 --path ~/Desktop --confirm

# Verbose logging for debugging
pinq receive ABC123 --verbose

Options

• --path <dir>: Override the download directory (default: ~/Downloads)
• --confirm: Ask for confirmation before saving incoming files
• --verbose: Print signaling/WebRTC debug output

Environment Variables

• SIGNALING_URL: Override the signaling server URL (default: https://pinq.onrender.com)
• DOWNLOAD_DIR: Override the default download directory for all runs

Notes

• Pairing codes are 6 characters and exclude O/0 to reduce input mistakes.
• The CLI pre-warms the signaling server and uses ~90s timeouts to survive Render cold starts.

Development

pnpm install
pnpm --filter pinq-cli build   # compile to dist/
pnpm --filter pinq-cli test    # run Node.js tests (@roamhq/wrtc required)