Install

Install once. Publish with your agent.

Pick the agent you use and open it with one click. The request arrives already typed in; your agent identifies the safe install path, explains the trust boundary, and asks before changing anything.

Recommended

Give this request to your agent

The agent checks for an existing installation first. A true first install uses the current Simple Host release and one active skills directory; an update always uses the installed permissioned updater.

View full agent prompt

Install the three Simple Host skills from {{SIMPLE_HOST_ORIGIN}}

First check whether you can actually read and write files on my computer. If you cannot — an ordinary ChatGPT chat window cannot — then stop, do not guess, and do not work around it. Tell me plainly that this has to run in the ChatGPT desktop app's coding agent, the part that can open a folder and edit files, and that I can ask in Slack #simple-host-support if I cannot find it.

Work out my home folder using the shell you are actually in: $HOME on macOS or in PowerShell, %USERPROFILE% only in cmd. Install into exactly one folder:
  Claude Code            <home>/.claude/skills
  ChatGPT or Cursor      <home>/.agents/skills

1. Read {{SIMPLE_HOST_ORIGIN}}/skills/version as JSON. Download the /skills.zip it names, then check the file's size and SHA-256 against that manifest.
2. Copy the three folders (simple-host, simple-host-builder, fix-paths-for-subpath-hosting) straight into the skills folder, with no extra folder wrapped around them. Do not run anything out of the archive. Confirm all three SKILL.md files exist and none still says {{VERSION}}.
3. From the exact skills root you selected, directly read <selected-root>/simple-host/references/account-recovery.md completely. Do not rely on the newly copied skill being discoverable yet. Follow that file before account creation, including its existing-config check, exact-destination preflight, and single-call save-and-verify transaction. Ask me for my work email only when that workflow requires it.
4. Tell me my username, and that I may need a new chat or an app restart before the skills show up.

Before changing anything, tell me conversationally in one or two sentences that Simple Host will install its tools in the selected skills root and save publishing access in the resolved config path, then wait for one yes covering both. Still show and honor every approval required by the host, tool, sandbox, or operating system. If anything fails, say what happened without exposing credentials and tell me to ask in Slack #simple-host-support.

What to do next

Go from a folder to a shared link

Create or open a website

Describe the page you need, or open an existing project with your agent.

Publish it

Ask your agent to use simple-host and include your work email on the first deploy.

For developers

First install only

Requires Node 22.20 or newer. These commands pin skills@1.5.20 and use both npm and CLI noninteractive flags, so there are no package, agent, destination, or confirmation questionnaires. Running one executes third-party npm code. Existing installations must use their permissioned updater instead.

macOS or Linux

ChatGPT desktop app

DISABLE_TELEMETRY=1 npx --yes skills@1.5.20 add {{SIMPLE_HOST_ORIGIN}} --global --agent codex --copy --skill simple-host --skill simple-host-builder --skill fix-paths-for-subpath-hosting --yes

Claude Code

DISABLE_TELEMETRY=1 npx --yes skills@1.5.20 add {{SIMPLE_HOST_ORIGIN}} --global --agent claude-code --copy --skill simple-host --skill simple-host-builder --skill fix-paths-for-subpath-hosting --yes

Windows PowerShell

ChatGPT desktop app

$env:DISABLE_TELEMETRY="1"; npx.cmd --yes skills@1.5.20 add "{{SIMPLE_HOST_ORIGIN}}" --global --agent codex --copy --skill simple-host --skill simple-host-builder --skill fix-paths-for-subpath-hosting --yes

Claude Code

$env:DISABLE_TELEMETRY="1"; npx.cmd --yes skills@1.5.20 add "{{SIMPLE_HOST_ORIGIN}}" --global --agent claude-code --copy --skill simple-host --skill simple-host-builder --skill fix-paths-for-subpath-hosting --yes

Required verification: after any command, confirm the selected root contains simple-host/SKILL.md, simple-host-builder/SKILL.md, and fix-paths-for-subpath-hosting/SKILL.md. Confirm the concrete server version appears in simple-host/SKILL.md where expected and none of the three files contains {{VERSION}}. Treat any partial result as a failed install, remove only skill roots newly created by that attempt, and use the verified ZIP fallback.

Manual first install

Install the verified ZIP yourself

This is a first-install escape hatch. If Simple Host already exists in an active skills root, use its permissioned updater instead.

Download the ZIP and manifest. Use both files from this Simple Host origin. Download skills.zip Download manifest
Verify, then extract into one skills root. Select the local skills.zip below. This page compares its file.size and SHA-256 with the current /skills/version manifest using browser-side Web Crypto. After a match, extract the three top-level folders into the single root your agent scans.
Select the downloaded skills.zip
The selected file stays in this browser tab. It is not uploaded, stored, or transmitted; only the manifest is fetched from this origin.
- ChatGPT desktop app: ~/.agents/skills on macOS/Linux or $HOME\.agents\skills on Windows.
- Claude Code: ~/.claude/skills on macOS/Linux or $HOME\.claude\skills on Windows.
- Other agents: use the one root the agent reports scanning.
If the app already loads a legacy copy from $CODEX_HOME/skills or ~/.codex/skills, do not add another root; update that existing copy or explicitly migrate it.
Restart and list the skills. Restart the agent, then ask it to list its installed skills. Confirm that simple-host, simple-host-builder, and fix-paths-for-subpath-hosting all appear.

Integrity and trust

One active copy, one explicit approval

Existing installations always update through their installed, permissioned updater and the verified first-party ZIP; they never use the first-install npx route. The pinned developer route executes a third-party npm CLI, while the ZIP route installs artifacts produced by this running Simple Host server.

The SHA-256 published at /skills/version proves that the ZIP matches the bytes served by this same origin. It is an integrity check, not a code-signing signature or independent proof of publisher identity.

Getting help

Ask in Slack

If your agent gets stuck installing, or reports something you did not expect, ask in #simple-host-support. Paste what the agent told you into the channel — that is usually enough to sort it out.