@wix/connect-dev

CLI tool for establishing SSH connections to Wix dev machines through Cloudflare Tunnels.

Installation

npx @wix/connect-dev

Commands

login

Authenticate with Wix using device code flow.

npx @wix/connect-dev login

Opens a browser for authentication and stores tokens locally.

whoami

Display the currently authenticated user.

npx @wix/connect-dev whoami

vscode <siteId> <projectId>

Connect to a dev machine and open in VS Code.

npx @wix/connect-dev vscode 9d9cbace-c65e-4428-8e85-d1b8a9af1193 a1b2c3d4-e5f6-7890-abcd-ef1234567890

cursor <siteId> <projectId>

Connect to a dev machine and open in Cursor.

npx @wix/connect-dev cursor <siteId> <projectId>

ssh <siteId> <projectId>

Connect to a dev machine via SSH.

npx @wix/connect-dev ssh <siteId> <projectId>

Connection Flow

1. Authenticate - Verify stored tokens or prompt for login
2. Ensure tunnel client - Check/install cloudflared binary
3. Generate SSH keys - Create Ed25519 key pair per project
4. Start remote tunnel - Call Wix API to establish Cloudflare tunnel
5. Configure SSH - Setup local SSH config with ProxyCommand
6. Launch client - Open VS Code, Cursor, or SSH session

Error Output

On failure, the CLI displays:

• Step that failed
• Error cause/message
• HTTP status code (if applicable)
• Request ID for support

✖ Unable to start tunnel on remote dev machine
✖ Cause: listSandboxes failed: Not Found
✖ Status: 404
✖ Request ID: abc123-def456

Configuration

Tokens are stored in ~/.wix/auth/account.json.

SSH configs are stored in ~/.ssh/wix-connect-dev.d/.

Development

yarn build        # Build the package
yarn test         # Run tests
yarn lint         # Run ESLint
yarn typecheck    # Type check
yarn format       # Format with Prettier

Requirements

• Node.js 18+
• VS Code or Cursor (for IDE commands)
• SSH client