# VibeKit

> Instant hosting for AI coding agents. Every app gets its own persistent AI agent, a real GitHub repo you own, a database, and a live domain at `yourapp.vibekit.bot`. Build, ship, and manage apps from web, iOS, CLI, or any MCP-compatible client.

VibeKit is infrastructure for the agent era: the app's source code is a real GitHub repo under the user's account (not a hosted project on our platform), the AI agent persists across sessions and remembers context, and you can bring your own Anthropic or OpenAI key (BYOK) or pay-as-you-go with a USD balance. No bundled-credit plans, no vendor lock-in.

## Core Documentation

- [API Reference (markdown)](https://vibekit.bot/SKILL.md): Full REST API — auth, endpoints, request/response shapes, rate limits
- [Plugin Manifest](https://vibekit.bot/.well-known/ai-plugin.json): OpenAI-style plugin metadata (auth scheme, logo, contact)
- [Developer Docs](https://docs.vibekit.bot): Getting started, templates, deploy guides
- [Homepage (markdown)](https://vibekit.bot/): The marketing page also responds with `text/markdown` when requested — includes product overview and pricing

## Integrations

- [Claude Code hosting](https://vibekit.bot/claude-code): Deploy apps from the Claude Code CLI; persistent agent lives in your repo
- [Cursor hosting](https://vibekit.bot/cursor): Deploy from Cursor with one command; live preview at `yourapp.vibekit.bot`
- [MCP server (npm)](https://www.npmjs.com/package/vibekit-mcp): Model Context Protocol server for Claude.ai, Cursor, and any MCP-compatible agent
- [vibekit-agent (npm)](https://www.npmjs.com/package/vibekit-agent): Run your local Claude Code agent remotely from the iOS app

## Comparisons

- [VibeKit vs Lovable](https://vibekit.bot/vs-lovable): Why owning the repo beats hosted-only projects
- [VibeKit vs Replit](https://vibekit.bot/vs-replit): Agent-native hosting vs IDE-in-browser
- [VibeKit vs Bolt](https://vibekit.bot/vs-bolt): Persistent agents vs one-shot generators

## Authentication

VibeKit uses bearer API keys, not OAuth 2.0 / OIDC. There is no `/.well-known/openid-configuration` because there is no authorization server — agents get a long-lived key once and send it in the `Authorization` header on every request.

- **Header**: `Authorization: Bearer vk_...` on every request to `https://app.vibekit.bot/api/v1/*`
- **Get a key**: `npm install -g vibekit && vibekit login`, or generate one in the dashboard
- **Verify**: `GET /api/v1/account` — returns 200 + your account info if the key is valid, 401 otherwise
- **Key format**: prefix `vk_` followed by an opaque token
- **Rotation**: keys don't expire; rotate from the dashboard (revokes old, issues new)

## Pricing (summary)

- Free tier — 10 sessions/month, BYOK or balance top-up
- Builder ($19/mo) — 3 hosted apps, 50 sessions, auto-healing
- Pro ($49/mo) — 10 hosted apps, 200 sessions, full agent auto-ops
- Balance top-ups — $5 / $15 / $50 never-expiring, for pay-as-you-go usage

## Optional

- [Status Page](https://vibekit.bot/status): Platform uptime + recent incidents
- [Examples Gallery](https://vibekit.bot/examples): Apps deployed on VibeKit