CLI

Status & Stop

List and stop background sessions with otterkit status and otterkit stop.

Docs for LLMs

Manage the background sessions started on this machine:

Terminal
# List running daemons
npx otterkit status

# Stop one by name
npx otterkit stop tunnel-a1b2c3d4

status shows each daemon's public URL, local target, auth and capture settings, and auto-stop time. It cleans up ended sessions automatically.

stop kills the local process and also shuts down the endpoint on the server, so billing stops right away. This matters for webhook endpoints: they are answered by the server and would otherwise stay live until their TTL. The capture log is kept, so you can still inspect and replay what the session received.

JSON output#

Add --json for machine-readable output. These commands accept it: tunnel --daemon, webhook --daemon, up, down, status, stop, inspect, await, replay, requests, send, verify, pulse, domain, subdomains list, whoami, balance, and logout. In JSON mode, errors come back as JSON too, with exit code 1.