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.

Updating a pub resets its expiry.

List pubs

spx pub list

The list output includes each URL and its expiry date.

Delete a pub

spx pub delete <slug-or-url>

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

Expiration

Pubs expire after 30 days by default.

When a pub expires, SPX may delete the underlying file at any time. Expired and deleted pubs are served the same way as pubs that never existed.

Permanent pubs are not currently supported.