# OtterKit

> OtterKit is a macOS desktop application and CLI for local development. It provides .localhost domains with automatic HTTPS, public tunnels, webhook testing, HTTP traffic inspection, port management, and certificate management - all in one native app. AI agents can provision and pay for tunnels programmatically via the OtterKit CLI using MPP (Machine Payments Protocol).

## Key Links

- [Home](https://www.otterkit.com)
- [Features](https://www.otterkit.com/#features)
- [Pricing](https://www.otterkit.com/#pricing)
- [FAQ](https://www.otterkit.com/#faq)
- [Changelog](https://www.otterkit.com/changelog)
- [Download (Apple Silicon)](https://releases.otterkit.com/latest/OtterKit_aarch64.dmg)
- [Download (Intel)](https://releases.otterkit.com/latest/OtterKit_Intel.dmg)
- [Full Documentation for LLMs](https://www.otterkit.com/llms-full.txt)

## Core Features

- **Local Domains**: Create beautiful .localhost domains for your projects. No more remembering port numbers.
- **Auto HTTPS**: Automatic SSL certificates with one-click trust. Get the green lock in your browser instantly.
- **Public Tunnels**: Share your local server with anyone. Get a public URL in seconds, no configuration needed. A modern ngrok alternative.
- **Webhook Testing**: Create instant webhook endpoints. Capture, inspect, and replay incoming requests.
- **Traffic Inspector**: Real-time HTTP traffic monitoring. See every request and response with full details.
- **Port Manager**: See what processes are running on any port. Kill them instantly and save favorites.
- **Certificate Manager**: Full control over your SSL certificates. Trust, regenerate, or export with ease.

## OtterKit CLI - Tunnels for AI Agents

AI agents can provision tunnels programmatically via the CLI, paying per tunnel with MPP (Machine Payments Protocol) using Tempo stablecoin payments (USDC and pathUSD). No desktop app installation required. The CLI auto-detects which wallet is available (Tempo Wallet first, mppx fallback) and prints the wallet address when connecting (e.g. "Using Tempo Wallet (0x1e69...)").

### Setup (one-time) - choose one option

**Option 1: Tempo Wallet (recommended)**
```bash
curl -fsSL https://tempo.xyz/install | bash && tempo wallet login
```
Tempo Wallet uses USDC by default. Access keys are scoped to USDC.

**Option 2: mppx**
```bash
npx mppx account create   # Creates wallet, stores key in OS keychain
npx mppx account fund     # Fund with pathUSD
```
If the server asks for USDC but the mppx wallet holds pathUSD, the CLI auto-swaps via Tempo DEX.

Use `--wallet tempo` or `--wallet mppx` to override auto-detection.

### Commands
```bash
npx otterkit tunnel <port>                    # Foreground tunnel ($0.01)
npx otterkit tunnel <port> --daemon           # Background tunnel, 1h ($0.01)
npx otterkit tunnel <port> --daemon --ttl 4h  # Background tunnel, 4h ($0.03)
npx otterkit webhook                           # Webhook endpoint ($0.01)
npx otterkit webhook --daemon --ttl 4h         # Background webhook, 4h ($0.03)
npx otterkit status                            # List running daemon tunnels/webhooks
npx otterkit stop <subdomain>                  # Stop a daemon tunnel/webhook
```

### CLI Pricing

- **Foreground**: $0.01 one-time (alive while terminal is open)
- **Daemon**: Flat pricing by TTL - 1m ($0.01), 1h ($0.01), 4h ($0.03), 12h ($0.05), 24h ($0.08)
- **Webhook**: Same pricing as tunnels - foreground $0.01, daemon TTL-based

### Agent Skill

Install the agent skill for AI coding agents:
```bash
npx skills add useotterkit/skill -g
```

## Desktop App Pricing

- **Free Trial**: 3-day free trial with full access to all features. No credit card required.
- **Pro**: $29/year - unlimited domains, tunnels, webhooks, traffic inspector, port manager, request replay, priority support, and all future updates.

## System Requirements

- macOS 12.0 (Monterey) or later
- Apple Silicon (M1, M2, M3, M4) or Intel-based Mac
- CLI: Node.js 18+ (any OS)