otterkit
v0.2.4
Published
OtterKit CLI — provision and connect tunnels for AI agents
Maintainers
Readme
otterkit
Instant tunnels and webhooks for AI agents. Pay per use with MPP stablecoin payments.
Quick Start
# One-time: set up a wallet
curl -fsSL https://tempo.xyz/install | bash
tempo wallet login
# Create a tunnel
npx otterkit tunnel 3000Commands
Tunnel
Expose a local port to the internet.
npx otterkit tunnel <port> # Foreground ($0.01)
npx otterkit tunnel <port> --daemon # Background, 1h ($0.01)
npx otterkit tunnel <port> --daemon --ttl 4h # Background, 4h ($0.03)Webhook
Capture incoming HTTP requests without a local server.
npx otterkit webhook # Foreground ($0.01)
npx otterkit webhook --daemon --ttl 4h # Background, 4h ($0.03)Manage Daemons
npx otterkit status # List running daemons
npx otterkit stop <subdomain> # Stop a daemonOptions
| Flag | Description | Default |
| ------------------ | -------------------------------- | ----------- |
| --host <host> | Local host to forward to | 127.0.0.1 |
| --account <name> | mppx account name | default |
| --wallet <type> | tempo or mppx | auto-detect |
| --daemon | Run in background | off |
| --ttl <duration> | Daemon TTL: 1m, 1h, 4h, 12h, 24h | 1h |
Pricing
| Mode | TTL | Price | | ---------- | ---------------------- | ----- | | Foreground | While terminal is open | $0.01 | | Daemon | 1 min | $0.01 | | Daemon | 1 hour | $0.01 | | Daemon | 4 hours | $0.03 | | Daemon | 12 hours | $0.05 | | Daemon | 24 hours | $0.08 |
Payments in USDC or pathUSD on Tempo mainnet.
Wallet Setup
Option 1 - Tempo Wallet (recommended):
curl -fsSL https://tempo.xyz/install | bash
tempo wallet loginOption 2 - mppx:
npx mppx account create
npx mppx account fundThe CLI auto-detects which wallet is available. Use --wallet tempo or --wallet mppx to override.
How It Works
- CLI pays for a tunnel via MPP (HTTP 402 payment flow)
- Server provisions a public URL like
https://agent-a1b2c3d4.otterkit.app - CLI connects via WebSocket and forwards traffic to your local port
- Two-level keepalive (30s + 120s) keeps the tunnel alive
Links
License
MIT
