CLI Reference

The Anonymily CLI (@anonymilyhq/cli) runs via npx — no global install needed.

`listen`

command

Listen for incoming webhooks on your Anonymily endpoint and forward them to a local port.

usage

$ npx @anonymilyhq/cli listen <port> [options]

Arguments

<port> number Local port to forward requests to. E.g. 3000, 8080.

Options

`--id, -i`	string	Use a custom named endpoint ID. Requires a claimed endpoint and a valid --token. E.g. --id stripe-dev
`--token, -t`	string	Personal Access Token (PAT) for authenticating to a privately claimed endpoint. Can also be set via ANONYMILY_TOKEN env var.

Examples

Anonymous random endpoint:

bash

$ npx @anonymilyhq/cli listen 3000

Named endpoint (stable URL across restarts):

bash

$ npx @anonymilyhq/cli listen 3000 --id stripe-dev --token pat_xxx

Token from environment variable:

bash

$ ANONYMILY_TOKEN=pat_xxx npx @anonymilyhq/cli listen 3000 --id stripe-dev

`feedback`

command

Submit feedback about the CLI.

usage

$ npx @anonymilyhq/cli feedback <rating> [message]

`<rating>`	1–5	Numeric rating. 1 = Poor, 5 = Excellent.
`[message]`	string	Optional feedback message.

example

$ npx @anonymilyhq/cli feedback 5 "Love the stable URLs!"

`ANONYMILY_TOKEN`	string	Personal Access Token. Used when --token is not passed. Set in your shell profile (.bashrc / .zshrc) to avoid pasting it every session.
`ANONYMILY_API_URL`	string	Override the API base URL. Defaults to https://api.anonymily.com. Useful for self-hosted or staging environments.

To generate a Personal Access Token, go to Account → API Tokens.