pathcopy-agent

PathCopy Agent

Pair this computer or server with the Remote Path Copy iPhone app.

Quick Start

npm install -g pathcopy-agent
pathcopy init "MacBook Pro"
pathcopy add ~/Documents/project project
pathcopy pair --qr
pathcopy service install
pathcopy service start

Open the iPhone app, tap add device, then scan the QR code or enter the 6-digit code.

Commands

pathcopy init [device name]
pathcopy add <directory> [display name]
pathcopy add
pathcopy choose [directory]
pathcopy roots
pathcopy remove <root id or name>
pathcopy pair [--qr]
pathcopy start
pathcopy service <install|start|stop|status>

Notes

• Requires Node.js 20 or newer.
• service supports macOS launchd and Linux systemd.
• Windows can still run pathcopy start manually; service install is not implemented yet.

For local relay testing:

PATHCOPY_RELAY_URL=ws://127.0.0.1:4173/api/agent/ws pathcopy pair --qr

pathcopy add and pathcopy choose <directory> support multiple selections:

Select directory numbers (example: 1,3 or 1-3): 1,3