# Deploy Surge

> Deploy static sites to Surge.sh with inventory tracking. Use when deploying, tearing down, or listing surge deployments. Triggers include "deploy to surge", "surge deploy", "teardown surge", "list deployments".

- Skill: `digital-stoic-org/deploy-surge` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add digital-stoic-org/deploy-surge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/digital-stoic-org/deploy-surge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: digital-stoic-org (https://skillmd.com/u/digital-stoic-org)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/digital-stoic-org/deploy-surge

---


# Deploy Surge

Deploy static files to Surge.sh with YAML inventory lifecycle management.

**Inventory**: `$PRAXIS_DIR/reference/deploy/surge-inventory.yaml`

## Argument Parsing

Parse `$ARGUMENTS` for subcommand routing:
- `deploy <path> <description> [--slug X]` → deploy flow
- `teardown <slug>` → teardown flow
- `list` → list flow
- No args or ambiguous → ask user which subcommand

## Subcommands

### `deploy`

1. **Validate**: `rtk summary which surge` — if missing: `bun install -g surge`
2. **Resolve target**: `--slug` → `<slug>.surge.sh` | default → `<prefix>-<8hex>.surge.sh`
3. **Confirm** — show target URL, wait for user approval
4. **Deploy**: `rtk summary surge <path> --domain <target>`
5. **Update inventory** — append entry per schema
6. **Report** — output live URL + inventory count

### `teardown`

1. Find entry by slug/URL in inventory
2. `rtk summary surge teardown <target>`
3. Set `status: torn-down`, add `torn_down` timestamp
4. Confirm teardown

### `list`

1. Read inventory, display table sorted active-first, newest-first
2. Show counts: `✅ N active | 🗑️ N torn-down`

See `reference.md` for inventory schema, error handling, and rules.