spx pub: share HTML

spx pub publishes a single standalone HTML file and returns an unlisted public URL.

This is particularly useful when an agent generates a report, benchmark, research note, or other static HTML artifact that you want to show to others without deploying a full web service:

# ask a coding agent
> summarize conversion pipeline into a visual diagram
> save it into report.html as a standalone html file

Publish a file

spx pub report.html

SPX uploads the file and prints a URL:

https://<slug>.pub.runspx.com/

spx pub <path> is equivalent to:

spx pub create <path>

You must be logged in to publish. Any SPX account that can deploy with spx run can publish with spx pub.

File requirements

• The upload must be one standalone HTML file.
• The filename must end in .html or .htm.
• The file must be 10 MB or smaller.

Put CSS, JavaScript, images, and other assets inline in the HTML file. spx pub does not upload a directory or asset bundle.

URL behavior

Only the root URL is served:

https://<slug>.pub.runspx.com/

Other paths, including /index.html, are not part of the public contract.

Pub URLs are unlisted, not private. Anyone with the URL should be treated as able to view the page.

Update a pub

Replace the HTML behind an existing pub and keep the same URL:

spx pub update <slug-or-url> report.html

<slug-or-url> can be either the slug or the full https://<slug>.pub.runspx.com/ URL.

List pubs

spx pub list

The list output includes each pub URL.

Delete a pub

spx pub delete <slug-or-url>

After deletion, the pub URL no longer serves the uploaded HTML.