# 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 tunnels programmatically via the OtterKit CLI using prepaid credits (log in once, agents provision automatically).

## 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 with prepaid OtterKit credits (1 credit = $0.01). Pricing is metered: 1 credit per connected hour (first hour charged at provision), never more than 10 credits per tunnel per day. Billing pauses while disconnected; tunnels auto-stop after a TTL (default 24h, max 7d). No desktop app installation required.

### Setup (one-time)

```bash
npx otterkit login   # opens the browser; sign in and approve
```

A token is saved to `~/.otterkit/credentials.json` — after that, any agent on the machine provisions automatically using your credits. Buy credits at https://app.otterkit.com. New accounts get a free-credit grant.

For headless/CI agents, set `OTTERKIT_TOKEN` (create a token at app.otterkit.com → API Tokens) instead of running `otterkit login`.

### Commands
```bash
npx otterkit login                             # One-time browser login
npx otterkit whoami                            # Show account + credit balance
npx otterkit tunnel <port>                     # Foreground tunnel (1 credit/hr)
npx otterkit tunnel <port> --daemon            # Background tunnel, auto-stops after 24h
npx otterkit tunnel <port> --daemon --ttl 3d   # Background tunnel, auto-stops after 3 days
npx otterkit webhook                           # Webhook endpoint (1 credit/hr)
npx otterkit webhook --daemon --ttl 4h         # Background webhook, auto-stops after 4h
npx otterkit intercept <port>                  # Capture + forward (1 credit/hr)
npx otterkit intercept                         # Capture only (1 credit/hr)
npx otterkit intercept <port> --daemon --ttl 4h  # Background intercept
npx otterkit inspect <subdomain>               # View captured requests
npx otterkit inspect <subdomain> --json        # Raw JSONL output
npx otterkit share <paths...>                  # Download URL for files/dirs (1 credit/hr)
npx otterkit share ./dist/                     # Share an entire directory
npx otterkit share ./dist/ --daemon --ttl 4h   # Background share
npx otterkit status                            # List running daemon tunnels/webhooks
npx otterkit stop <subdomain>                  # Stop a daemon tunnel/webhook
```

### CLI Pricing (metered)

- **Rate**: 1 credit ($0.01) per connected hour; the first hour is charged at provision
- **Daily cap**: never more than 10 credits ($0.10) per tunnel per rolling 24h — hours beyond are free
- **Disconnected**: free — billing pauses
- **Auto-stop**: default 24h, `--ttl` up to 7d (safety only — a forgotten tunnel bills at most the cap, then stops)
- **Webhook / intercept / share**: same pricing as tunnels. Intercept logs to ~/.otterkit/requests/<subdomain>.jsonl
- Machine-readable pricing: GET https://otterkit.app/api/agent/pricing

### 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)