Skip to main content

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.

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

​
Step 1: Install or refresh

curl -fsSL https://simplehost.dev/install.sh | bash
If SimpleHost was already installed before, run the same command again to refresh to the latest version of the skill. Or if you prefer npx: npx skills add sk-code-01/simplehost-skill -g -y Works with Claude Code, Cursor, Windsurf, and any agent supporting the Agent Skills 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. Newer versions of the skill also check for updates automatically, but the install command above is always the simplest way to refresh immediately.

​
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.
That’s the entire flow. Install → publish → done. Your agent handles everything.

​
For humans (manual)

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

​
Get the publish script

curl -fsSL https://simplehost.dev/publish.sh -o publish.sh && chmod +x publish.sh

​
Publish a directory

export SIMPLEHOST_API_KEY="sh_live_your_key_here"
./publish.sh ./dist

​
Update an existing site

./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 for full details. 
# 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:

​
Next steps

Skill usage examples

See what agents can do with SimpleHost.

Plans & Limits

Free tier gets you 500 sites and 10 GB.

How it works

Architecture and publish flow details.