HTML Share Default Tool

Fleet helper CLI and skill for publishing composed, self-contained HTML documents as shareable browser links.

The stack now includes html-share, a default helper CLI for cases where the agent should deliver a link instead of a PDF or a long chat response: visual explainers, mockups, comparisons, implementation notes, or editorial reports.

Default behavior: create a self-contained kami-style .html file, save it under ~/.hermes/cache/documents/html/, upload it with html-share upload, and return the generated URL.

What changed

Helper CLI

bin/html-share uploads HTML via multipart form data and returns JSON with url, id, and expiresAt.

Skill

skills/html-share/SKILL.md tells agents when to create a browser document, how to apply kami styling, and how to publish safely.

Docs

config/AGENTS.md, docs/HELPER_CLIS.md, SOUL.md, and CHARTER.md now describe the workflow.

Provisioning

apply-hermes-config.sh creates the HTML output directory and seeds HTML_SHARE_UPLOAD_URL.

Agent workflow

mkdir -p ~/.hermes/cache/documents/html
# write a self-contained HTML document
html-share upload ~/.hermes/cache/documents/html/explainer.html --expiry 30d

Command	Purpose
`html-share health`	Verifies endpoint configuration and prints allowed expiries.
`html-share upload file.html --expiry 30d`	Publishes a document and returns the share URL as JSON.
`--expiry 1d\|7d\|30d\|never`	Controls link lifetime. Sensitive documents should use shorter expiries.
`--open`	Best-effort local browser open after upload.

Safety model

Never upload secrets, raw env files, credentials, or private keys.
Prefer redacted summaries over raw private customer data.
Use 30d by default; use never only when explicitly requested.
The CLI refuses non-HTTPS upload endpoints and non-HTML file extensions.

Verification

The helper CLI compliance check passed with 39 passes and 0 failures. This page itself was generated as a live smoke test for the new workflow.

kamiself-containedshareablefleet-default