Skip to main content
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: 
npx skills add sk-code-01/simplehost-skill
Prefer a script? Download it first so you can read it, then run it: 
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 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.
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 200 MB.

How it works

Architecture and publish flow details.