> ## 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.

# Installation

> Install or refresh the SimpleHost skill for your AI coding agent

## Install via npx (recommended)

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

Add `-g` to install globally (available in all projects). Works with Claude Code, Cursor, Windsurf, and any agent supporting the Agent Skills standard. Run the same command again any time to refresh to the latest version of the skill.

## Install via script

Download it first so you can inspect it, then run it:

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

No npm needed. Re-run any time to refresh.

## Manual Install

If neither method works, you can install manually:

### Claude Code

```bash theme={null}
mkdir -p ~/.claude/skills/simplehost
curl -fsSL https://simplehost.dev/SKILL.md \
  -o ~/.claude/skills/simplehost/SKILL.md
```

### Cursor

```bash theme={null}
mkdir -p .cursor/skills/simplehost
curl -fsSL https://simplehost.dev/SKILL.md \
  -o .cursor/skills/simplehost/SKILL.md
```

Manual installs can also be refreshed later by downloading `https://simplehost.dev/SKILL.md` again to the same location.

## Verify Installation

Start a new Claude Code session and type:

```
/simplehost
```

If the skill is installed, Claude will activate it and ask what you want to publish.

<Tip>
  When a newer version is published, the publish script surfaces a one-line "update available" notice with the command to run — it never fetches or updates anything on its own.
</Tip>

## Set Your API Key

For permanent publishing, set your API key as an environment variable:

```bash theme={null}
export SIMPLEHOST_API_KEY="sh_live_your_key_here"
```

Add it to your shell profile (`~/.zshrc` or `~/.bashrc`) to persist across sessions:

```bash theme={null}
echo 'export SIMPLEHOST_API_KEY="sh_live_your_key_here"' >> ~/.zshrc
```

<Tip>
  Don't have an API key? The skill will guide you through the authentication flow on first use. Just say "publish this" and follow the prompts.
</Tip>

## Requirements

The skill uses `publish.sh` which requires:

* `curl` — Pre-installed on macOS and most Linux
* `jq` — Pre-installed on macOS. Install on Linux: `sudo apt install jq`

## Uninstall

### Global

```bash theme={null}
npx skills remove simplehost -g
```

### Manual

```bash theme={null}
rm -rf ~/.claude/skills/simplehost
```