# RunPrompt

> Turn any AI prompt into a shareable link. One URL works with ChatGPT, Claude, Perplexity, Gemini, and Grok.

RunPrompt encodes prompts into short, shareable URLs. When someone opens the link, they pick their preferred AI and the prompt loads automatically. No accounts, no servers storing prompts, no tracking.

## API

Base URL: https://runprompt.link

### Create a shareable prompt link

POST /api/shorten
Content-Type: application/json

Request body:
- `prompt` (string, required): The prompt text. Max 3,000 characters.
- `slug` (string, optional): Custom vanity slug (2-64 chars, lowercase alphanumeric and hyphens). If omitted, a contextual slug is auto-generated from the prompt.

Example request:
```json
{
  "prompt": "Explain quantum computing to a 10-year-old using only basketball analogies",
  "slug": "quantum-basketball"
}
```

Example response (201):
```json
{
  "slug": "quantum-basketball",
  "short_url": "https://runprompt.link/quantum-basketball",
  "full_url": "https://runprompt.link/#p=RXhwbGFpbi..."
}
```

### Check slug availability

GET /api/check?slug=my-slug

Example response:
```json
{
  "available": true,
  "slug": "my-slug"
}
```

## How it works

1. The prompt is base64-encoded and stored in the URL hash fragment
2. A short redirect URL is created and stored in Cloudflare KV (1-year expiry)
3. When someone visits the short URL, they're redirected to the full URL
4. The prompt is decoded entirely in the browser — no server ever reads the prompt text
5. The recipient picks their AI (ChatGPT, Claude, Perplexity, Gemini, Grok) and the prompt loads automatically

## When to use RunPrompt

- A user wants to share a prompt with someone who uses a different AI
- A user wants to create a reusable link for a prompt they use often
- A user wants to share a prompt publicly without locking it to one platform
- A user asks you to "make this prompt shareable" or "create a link for this prompt"

## Example usage for LLMs

When a user asks you to share or create a link for a prompt, you can call the API:

```
POST https://runprompt.link/api/shorten
{"prompt": "the user's prompt text here"}
```

Then return the `short_url` from the response. The user gets a clean, short link they can share anywhere.