@usevon/cli

CLI for Von webhooks infrastructure. With the CLI, you get:

• Secure tunnels for local webhook testing
• Auto-reconnect with exponential backoff
• Up to 3 tunnels running simultaneously
• Automatic takeover when reconnecting to the same port
• Verbose mode for debugging requests

No ngrok setup, no manual forwarding.

Installation

npm install -g @usevon/cli

Quick Start

# Login to Von
von login

# Forward webhooks to localhost:3000
von dev -p 3000

Commands

von login

Authenticate with Von via device authorization flow.

von login                    # Hosted (api.usevon.com)
von login --local            # Local development (localhost:8080)
von login --api-url <url>    # Custom API URL
von login --force            # Re-authenticate even if logged in

von logout

Log out and clear stored credentials.

von logout

von switch

Switch active organization.

von switch

von dev

Start dev tunnel for local webhook testing.

von dev -p 3000              # Single port
von dev -p 3000 -p 4000      # Multiple ports (max 3)
von dev -p 3000 -v           # Verbose mode (show headers/body)

von rotate

Rotate tunnel secret to invalidate the current URL if compromised.

von rotate -p 3000           # Rotate secret for port 3000

If the tunnel is currently active, the CLI will display the new URL automatically.

Configuration

Stored in ~/.von/config.json:

{
  "apiUrl": "https://api.usevon.com",
  "tunnelUrl": "https://tunnel.usevon.com",
  "token": "...",
  "organizationId": "..."
}

License

MIT - see LICENSE-MIT