Terminal
Terminal/Skill
Gets ngrok installed and authenticated with an authtoken or API key, for the CLI, an SDK, or Terraform and Kubernetes.
By ngrok
Works with
npx skills add ngrok/skills --skill ngrok-setupGet the user authenticated and pointed at the right surface. Every ngrok action requires an authtoken (agent/SDK) or an API key (IaC) - there is no unauthenticated mode; this is deliberate abuse prevention.
Pick from what the user is doing, then defer the how-to to that surface skill:
ngrok-surfaces carries the routing table and the per-surface mechanics - read it off the user's project rather than asking. In short: a terminal means the agent CLI, an ngrok dependency in a manifest means the SDK, *.tf or k8s manifests mean infrastructure-as-code, and a controlplane provisioning per-tenant resources means the REST API.
If it is not obvious, the terminal path is the safe default for one-off tasks.
CLI / SDK (authtoken):
Check for an existing token: ngrok config check, and check the NGROK_AUTHTOKEN env var.
If none is set, have the user set it themselves - do not ask them to paste the token to you. Give them the link and the exact command to run:
Grab your authtoken from https://dashboard.ngrok.com/get-started/your-authtoken, then run:
ngrok config add-authtoken <YOUR_TOKEN>
On a headless box, or where the token comes from a secret store, export NGROK_AUTHTOKEN=<YOUR_TOKEN> in their environment does the same job.
Tell them to say when it is done, then re-run ngrok config check to confirm and carry on with the original task. Run every other ngrok command yourself - the authtoken is the one step that stays with the user.
IaC and the REST API (API key): Terraform, the operator, and api.ngrok.com authenticate with an ngrok API key (the operator needs an API key and an authtoken), not the agent authtoken. Point the user to https://dashboard.ngrok.com/api-keys and have them set it as the provider/operator credential or NGROK_API_KEY. See ngrok-surfaces.
The two credentials are not interchangeable and have very different blast radii: an API key administers the account, an authtoken only starts agent sessions. If a call fails with an auth error, check which one is in play before rotating anything.
ngrok is not installed, install it (brew install ngrok, or the platform package). Confirm with ngrok --help.ngrok-surfaces.ngrok-surfaces.Once authenticated and the surface is ready, return to whatever the user actually asked for (expose a service, receive webhooks, etc.).
POST /credentials.