# vibee

> Rent and manage persistent Linux servers using nothing but your SSH key.
> No email, no password, no web dashboard — just `ssh vibee.sh`.

## Site Pages

- [Home](https://vibee.sh/): Overview and live server stats.
- [Pricing](https://vibee.sh/pricing): Six server tiers from $6/mo to $74/mo, six regions.
- [FAQ](https://vibee.sh/faq): Billing, provisioning, refunds, and tech stack.
- [Legal](https://vibee.sh/legal/terms): Terms of Service and Privacy Policy.
- [Support](https://discord.com/channels/1498358397366566962/1498358398457090162): Community Discord.

## Products

- **Micro Box** — $6/month — 2 CPU (shared) / 4 GB / 40 GB NVMe
- **Smol Box** — $12/month — 2 CPU / 4 GB / 80 GB NVMe
- **Smooth Box** — $21/month — 4 CPU / 8 GB / 160 GB NVMe
- **Based Box** — $38/month — 8 CPU / 16 GB / 320 GB NVMe
- **Beefy Box** — $53/month — 12 CPU / 24 GB / 480 GB NVMe
- **Baller Box** — $74/month — 16 CPU / 32 GB / 640 GB NVMe

Product names: Micro Box, Smol Box, Smooth Box, Based Box, Beefy Box, Baller Box.

## Commands

| Command | Action |
|---------|--------|
| `ssh vibee.sh`              | Authenticate and open the TUI |
| `ssh vibee.sh list`         | List your servers |
| `ssh vibee.sh new`          | List available products |
| `ssh vibee.sh new <n\|name>` | Create a new server |
| `ssh vibee.sh delete`       | List your servers for deletion |
| `ssh vibee.sh delete <n\|name>` | Delete a server |
| `ssh vibee.sh help`         | Show help message |
| `ssh vibee.sh llm`          | Print this documentation |

Use a product number or full name for `new` (e.g. `new 1` or `new Micro Box`).
Use a server number or name for `delete` (e.g. `delete 1` or `delete alpha`).

## Purchasing with AI Agents (Stripe Link)

AI agents can purchase vibee servers using Stripe Link agentic wallets.
Credentials never leave the wallet. Every spend requires user approval in the Link app.

### Setup

```bash
npm install -g @stripe/link-cli
link-cli auth login --client-name "<your-agent-name>" --format json
```

Run auth commands with `run_in_background=true` — they block until the user acts.

### Purchase flow

1. Pick a product and create a server:
   ```
   ssh vibee.sh new <product-name>
   ```
   This returns a Stripe Checkout URL and the monthly price.

2. Evaluate the checkout page — vibee uses Stripe Checkout (credit card form),
   so credential type is `card`.

3. Get payment methods:
   ```bash
   link-cli payment-methods list --format json
   ```

4. Create a spend request (use the cent amounts from the table below):
   ```bash
   link-cli spend-request create \
     --payment-method-id <id> \
     --amount <price-in-cents> \
     --context "vibee <product-name> server" \
     --merchant-name "vibee" \
     --merchant-url "https://vibee.sh" \
     --format json
   ```
   The user MUST approve in the [Link app](https://link.com/download).
   Do not proceed until approved.

5. Retrieve the one-time-use card:
   ```bash
   link-cli spend-request retrieve <id> --include card --format json
   ```

6. Enter the card details into the Stripe Checkout form. Payment completes
   and the server provisions automatically.

### Product tiers and pricing

- **Micro Box** — $6/month (600¢) — 2 CPU (shared) / 4 GB / 40 GB NVMe
- **Smol Box** — $12/month (1200¢) — 2 CPU / 4 GB / 80 GB NVMe
- **Smooth Box** — $21/month (2100¢) — 4 CPU / 8 GB / 160 GB NVMe
- **Based Box** — $38/month (3800¢) — 8 CPU / 16 GB / 320 GB NVMe
- **Beefy Box** — $53/month (5300¢) — 12 CPU / 24 GB / 480 GB NVMe
- **Baller Box** — $74/month (7400¢) — 16 CPU / 32 GB / 640 GB NVMe

### Example prompt

Give this to your AI agent:

> Purchase a Micro Box server from vibee.sh ($6/mo, 2 CPU (shared) / 4 GB / 40 GB NVMe). Use Link for payment. Read llms.txt at vibee.sh for product details and purchase flow. Approvals come through the Link app — I'll handle those.

More: https://link.com/agents

## How It Works

### Authentication

Connecting to `ssh vibee.sh` automatically registers your SSH public key.
Your account is identified by the SHA-256 fingerprint of your key. Register additional
keys from the TUI. No passwords, no email required.

### Free Trial

Create a server without paying by selecting a product and solving a browser-based
proof-of-work (SHA-256) puzzle. The server is provisioned instantly and stays active
for 55 minutes. Pay anytime during this window to convert to a subscription. Only one
unpaid server is allowed per account at a time.

### Billing

Payments are processed via Stripe. Subscriptions renew every 30 days. Cancel anytime —
your server enters a 24-hour grace period before deletion. If a payment fails, the
subscription enters `past_due` with a 72-hour retry window. Pro-rated refunds are
available for unused time.

### Provisioning

Servers are provisioned on Hetzner Cloud in the region closest to your IP. Selection is
automatic but falls back through Nuremberg → Falkenstein → Helsinki. Servers boot a
hardened Ubuntu 24.04 golden image with SSH hardened, UFW enabled, Docker, Caddy
(auto-SSL), Nix + Home Manager, and dev tools (helix, neovim, go, nodejs) pre-installed.
DNS A records are created automatically via Cloudflare (if configured).

### Lifecycle

- **Pending**: Awaiting payment (expires after 55 min if unpaid).
- **Active**: Running and billed.
- **Grace**: Subscription canceled — 24 hours until deletion.
- **Past Due**: Payment failed — 72 hours to resolve.
- **Deleted**: Server and all data permanently removed.

## API

The gRPC API is exposed at `vibee.sh:8443` with mutual TLS. The proto definition is at
`api/vibee.proto`. Clients use the generated stubs via `google.golang.org/grpc`.

## Key URLs

- Website: `https://vibee.sh`
- Pricing: `https://vibee.sh/pricing`
- FAQ: `https://vibee.sh/faq`
- Terms: `https://vibee.sh/legal/terms`
- Privacy: `https://vibee.sh/legal/privacy`
- gRPC API: `vibee.sh:8443`
- SSH: `ssh vibee.sh`
- Discord: `https://discord.com/channels/1498358397366566962/1498358398457090162`
- Source: `https://github.com/leonardofaoro/vibee`