shiply-cli 0.3.0 → 0.4.1

package/dist/confetti.js

@@ -2,7 +2,7 @@ const GLYPHS = ['✦', '✧', '★', '☆', '●', '◆', '▲', '■', '♥', '
 const COLORS = [196, 202, 208, 220, 226, 118, 46, 51, 45, 39, 99, 201, 207, 213];
 const ESC = '\x1b';
 /** Full-width ANSI confetti burst — sites going live deserve a party. */
-export function confetti(message = '🎉  SITE IS LIVE  🎉') {
+export function confetti(message = '⛵  SITE IS LIVE  ⛵') {
     const cols = Math.min(process.stdout.columns ?? 80, 100);
     const rows = Math.min(Math.max((process.stdout.rows ?? 24) - 6, 8), 18);
     let out = '\n';

package/dist/index.js

@@ -4,6 +4,7 @@ import { parseArgs } from 'node:util';
 import { confetti } from './confetti.js';
 import { loadApiKey, saveApiKey } from './config.js';
 import { api, DEFAULT_BASE, publish, resolveBase } from './publish.js';
+import { installSkill } from './skill.js';
 import { readState, writeState } from './state.js';
 import { checkReadiness, targetToHostname } from './status.js';
 const HELP = `shiply — instant static hosting for agents (https://shiply.now)
@@ -13,6 +14,8 @@ Usage:
                                               Re-running UPDATES the same site (state in .shiply.json)
   shiply update <dir>                         Same as publish when .shiply.json exists
   shiply status <slug-or-domain> [--wait]     SSL + readiness check (agent-friendly output)
+  shiply skill [--project]                    Install the shiply skill for your AI agent
+                                              (global ~/.claude/skills, or ./.claude/skills with --project)
   shiply login [--email <address>]            Email a 6-digit code, mint + save an API key
   shiply help
 
@@ -69,6 +72,7 @@ async function main() {
             email: { type: 'string' },
             wait: { type: 'boolean' },
             'new-site': { type: 'boolean' },
+            project: { type: 'boolean' },
             timeout: { type: 'string' },
             'no-confetti': { type: 'boolean' },
             help: { type: 'boolean', short: 'h' },
@@ -121,7 +125,7 @@ async function main() {
                 if (live.status < 400) {
                     console.log(`SITE_READY url=${res.siteUrl} status=${live.status}`);
                     if (!values['no-confetti'])
-                        console.log(confetti(`🎉  ${host} IS LIVE  🎉`));
+                        console.log(confetti(`⛵  ${host} IS LIVE  ⛵`));
                 }
             }
             catch {
@@ -165,6 +169,14 @@ async function main() {
                 await new Promise((r) => setTimeout(r, 5000));
             }
         }
+        case 'skill': {
+            const written = await installSkill(Boolean(values.project));
+            for (const w of written)
+                console.log(`✔ skill installed — ${w}`);
+            console.log('  Your agent now knows how to publish, update (same URL!), check SSL, and more.');
+            console.log('  Restart the agent session to pick it up. Re-run after CLI upgrades.');
+            return;
+        }
         case 'login': {
             const base = resolveBase(values.base);
             const rl = createInterface({ input: process.stdin, output: process.stdout });

package/dist/skill.js

@@ -0,0 +1,29 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The SKILL.md ships inside the npm package (skill/SKILL.md next to dist/). */
+export async function bundledSkill() {
+    const here = dirname(fileURLToPath(import.meta.url)); // <pkg>/dist
+    return readFile(join(here, '..', 'skill', 'SKILL.md'), 'utf8');
+}
+/** Where agents look for skills. Claude Code is the reference layout
+ *  (~/.claude/skills/<name>/SKILL.md); several other agents read the same
+ *  format from their own folders. */
+export function installTargets(project) {
+    if (project) {
+        return [{ agent: 'this project (Claude Code & compatible)', dir: join(process.cwd(), '.claude', 'skills', 'shiply') }];
+    }
+    return [{ agent: 'Claude Code (all projects)', dir: join(homedir(), '.claude', 'skills', 'shiply') }];
+}
+export async function installSkill(project) {
+    const content = await bundledSkill();
+    const written = [];
+    for (const t of installTargets(project)) {
+        await mkdir(t.dir, { recursive: true });
+        const file = join(t.dir, 'SKILL.md');
+        await writeFile(file, content);
+        written.push(`${t.agent}: ${file}`);
+    }
+    return written;
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "shiply-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Publish static sites to shiply.now from the command line — instant web hosting for agents.",
   "license": "MIT",
   "type": "module",
   "bin": { "shiply": "dist/index.js" },
-  "files": ["dist", "README.md"],
+  "files": ["dist", "skill", "README.md"],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "prepublishOnly": "pnpm build",

package/skill/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: shiply
+description: Publish static sites to the web instantly with shiply.now and manage them (updates, SSL checks, custom domains, variables). Use when the user asks to publish, host, deploy, share, or update a website/page/demo/report, or wants a live URL for generated files. Triggers - "publish this", "host this", "put this online", "give me a link", "update the site", shiply.
+---
+
+# shiply — instant web hosting for agents
+
+shiply.now puts files on the web in seconds. No account needed to start:
+anonymous sites are live immediately, last 24 hours, and can be claimed into
+an account to keep them. The cardinal rule:
+
+**NEVER create a new site to update an existing one. Always re-publish to the
+same site** — otherwise you litter subdomains and lose the user's URL.
+
+## Pick your interface (best first)
+
+### 1. MCP (native tools)
+If the `shiply` MCP server is connected (https://shiply.now/mcp), use
+`publish_site`. Every result includes a `toUpdate` field telling you the exact
+call for updates — follow it. Other tools: `site_status`, `list_sites`,
+`set_handle`, `set_variable`, `add_domain`, `check_domain`, `get_analytics`,
+`delete_site`, `rollback` via dashboard.
+
+### 2. CLI
+```bash
+npm i -g shiply-cli        # or: curl -fsSL https://shiply.now/install.sh | bash
+shiply publish ./dir       # live URL + confetti
+shiply publish ./dir       # run AGAIN after edits → updates the SAME site
+shiply status <slug> --wait  # SSL + readiness; prints SSL_READY / SITE_READY
+shiply login               # email code → API key → sites become permanent
+```
+The CLI stores each directory's site in `.shiply.json` (slug + update token),
+so repeat publishes reuse the URL automatically. `--new-site` opts out.
+Gitignore `.shiply.json` in public repos. Parse `SITE_READY` / `SSL_READY`
+lines for automation; exit code 0 = ready.
+
+### 3. Raw HTTP (no installs)
+```
+1. POST https://shiply.now/api/v1/publish
+   {"files":[{"path":"index.html","size":<bytes>,"contentType":"text/html","hash":"<sha256, optional>"}]}
+   (+ "Authorization: Bearer shp_…" for permanent owned sites)
+2. PUT each file's bytes to response upload.uploads[].url
+3. POST upload.finalizeUrl with {"versionId":"..."}
+```
+**Updates:** anonymous → include `"claimToken":"..."` (returned ONCE by the
+first publish — save it); owned → include `"slug":"..."`. Hashes make updates
+cheap: unchanged files are skipped server-side.
+
+## The lifecycle to explain to users
+- Anonymous site: live instantly, expires in 24 h. Give the user the
+  `claimUrl` — claiming keeps it forever on a free account.
+- API key (`shiply login` or POST /api/auth/agent/request-code →
+  verify-code): publishes are permanent and manageable.
+- Paid plans add vanity handles (<name>.shiply.now), more custom domains,
+  storage, analytics: https://shiply.now/dashboard/plan
+
+## Power features (Bearer key)
+- **Custom domains**: POST /api/v1/domains {"hostname","slug"} → tell the
+  user to CNAME the hostname to `cname.shiply.now` → cert auto-issues; poll
+  GET /api/v1/domains/{id}/check until `ready:true`.
+- **SSL/readiness checker**: `shiply status <slug-or-domain> --wait` or the
+  check endpoint — confirms certificate + serving before telling the user
+  it's done.
+- **Variables**: encrypted per-user KV for API keys the user's sites need
+  (GET/PUT /api/v1/variables, DELETE /api/v1/variables/{NAME}); Supabase can
+  be connected from the dashboard and lands here as SUPABASE_URL +
+  SUPABASE_ANON_KEY.
+- **Rollback**: POST /api/v1/publish/{slug}/rollback {"versionId"} flips any
+  finalized version live instantly.
+- **SPA**: pass `"spaMode":true` so deep links serve index.html.
+
+## Limits & references
+≤1000 files/site (≤50 inline via MCP), ≤100 MiB/file, 1 GiB total.
+Machine guide: https://shiply.now/llms.txt · OpenAPI:
+https://shiply.now/openapi.json · Docs: https://shiply.now/docs