/share-page

description: Deploy a generated visual-explainer HTML page and return a live Vercel URL

Share Visual Explainer Page

Share a visual explainer HTML file instantly via Vercel. Returns a live URL with no authentication required when a Pi-compatible `vercel-deploy` skill is installed.

Usage

/share-page <file-path>

**Arguments:**

• `file-path` - Path to the HTML file to share (required)

**Examples:**

/share-page ~/.agent/diagrams/my-diagram.html
/share-page /tmp/visual-explainer-output.html

How It Works

1. Finds the `visual-explainer` skill directory for the current harness 2. Copies your HTML file to a temp directory as `index.html` 3. Deploys via the Pi-compatible `vercel-deploy` skill 4. Returns a live URL immediately

Requirements

• **vercel-deploy skill** - Required for deployment. In Pi, install with: `pi install npm:vercel-deploy`

No Vercel account, Cloudflare account, or API keys needed. The deployment is "claimable", you can transfer it to your Vercel account later if you want.

Script Location

Resolve the script from the installed skill directory, then run it with the HTML file path:

bash ~/.pi/agent/skills/visual-explainer/scripts/share.sh <file>

If the skill is installed somewhere else, use that install path instead. Common locations include `~/.codex/skills/visual-explainer/scripts/share.sh`, `~/.config/opencode/skill/visual-explainer/scripts/share.sh`, or `./plugins/visual-explainer/scripts/share.sh` from a repository checkout.

The script currently looks for the Pi-compatible `vercel-deploy` script in the standard Pi skill locations. Other harnesses can generate and open HTML normally, but sharing requires that dependency to be available in a compatible location.

Output

Sharing my-diagram.html...

✓ Shared successfully!

Live URL:  https://skill-deploy-abc123.vercel.app
Claim URL: https://vercel.com/claim-deployment?code=...

The script also outputs JSON for programmatic use:

{"previewUrl":"https://...","claimUrl":"https://...","deploymentId":"...","projectId":"..."}

Notes

• Deployments are **public**, anyone with the URL can view
• Preview deployments have a configurable retention period (default: 30 days)
• Each share creates a new deployment with a unique URL