> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplehost.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Give your agent the ability to publish in under 30 seconds

## For agents (recommended)

Install the SimpleHost skill and your agent can publish anything to the web.

### Step 1: Install or refresh

The simplest, cross-agent way is the package registry:

```bash theme={null}
npx skills add sk-code-01/simplehost-skill
```

Prefer a script? Download it first so you can read it, then run it:

```bash theme={null}
curl -fsSL https://simplehost.dev/install.sh -o /tmp/simplehost-install.sh
bash /tmp/simplehost-install.sh
```

Already installed? Re-run either command any time to refresh to the latest version of the skill.

Works with **Claude Code**, **Cursor**, **Windsurf**, and any agent supporting the [Agent Skills](https://agentskills.io) standard.

### Step 2: Publish

Open a new agent session and say:

```
Publish this project
```

or

```
Deploy my dist folder to the web
```

or

```
Give me a live URL for this site
```

The agent handles everything — scanning files, uploading, and returning a live URL.

Your agent publishes instantly — no questions, no setup. If you don't have an API key, it publishes as a temporary link (expires in 24 hours). After publishing, the agent will offer to make it permanent for free.

When a newer skill version is available, SimpleHost surfaces a one-line notice after a publish — re-run the install command above (or `npx skills update simplehost`) to refresh. It never updates anything on its own.

### Step 3: Make it permanent (optional)

After your first publish, the agent will say:

```
Agent: "Your site is live! This link expires in 24 hours.
        Want me to make it permanent? It's free — I just
        need your email and it takes 30 seconds."

You:   "yes, use me@example.com"

Agent: "Check your email for a verification code (XXXX-XXXX)."

You:   "ABCD-1234"

Agent: "Done! Your site is now permanent.
        https://bright-canvas-a7k2.simplehost.dev/"
```

The agent saves your API key automatically. From now on, every publish is permanent — no setup ever again.

<Tip>
  That's the entire flow. Install → publish → done. Your agent handles everything.
</Tip>

***

## For humans (manual)

If you prefer to publish directly from the command line without an agent:

### Get the publish script

```bash theme={null}
curl -fsSL https://simplehost.dev/publish.sh -o publish.sh && chmod +x publish.sh
```

### Publish a directory

```bash theme={null}
export SIMPLEHOST_API_KEY="sh_live_your_key_here"
./publish.sh ./dist
```

### Update an existing site

```bash theme={null}
./publish.sh ./dist bright-canvas-a7k2
```

Only changed files are uploaded. Unchanged files are copied server-side.

***

## For developers (API)

Build your own integration with the REST API. See the [API Reference](/api-reference/overview) for full details.

```bash theme={null}
# Create a site
curl -X POST https://simplehost.dev/api/v1/publish \
  -H "Authorization: Bearer sh_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"files": [{"path": "index.html", "size": 1024, "contentType": "text/html"}]}'

# Upload files to the returned presigned URLs
# Then finalize to go live
```

Your agent can also discover the API automatically via:

* [`/llms.txt`](https://simplehost.dev/llms.txt) — AI-readable docs index
* [`/openapi.json`](https://simplehost.dev/openapi.json) — Full OpenAPI 3.1.0 spec

***

## Next steps

<CardGroup cols={2}>
  <Card title="Skill usage examples" icon="robot" href="/skill/usage">
    See what agents can do with SimpleHost.
  </Card>

  <Card title="Plans & Limits" icon="gauge" href="/guides/plans-and-limits">
    Free tier gets you 500 sites and 200 MB.
  </Card>

  <Card title="How it works" icon="gears" href="/how-it-works">
    Architecture and publish flow details.
  </Card>
</CardGroup>