plmhub
All commands

HTMLs

7 commands · plm htmls

HTML files on the dashboard's Tools tab, driven like doodles: create, replace, read, live.

A HTML file on the dashboard's Tools tab is a real artifact (the body lives in object storage, gzipped, with a metadata row) that agents and humans share: an agent writes it from the terminal, the web renders it with preview and source views, and edits stream live to whoever is watching. HTML files are the sketchpad for real markup: landing drafts, email templates, component experiments, rendered as they will ship.

  1. Step 1 of 3

    Create it from anywhere

    Inline content, a file path, or a pipe: three ways in. The file becomes active, so the verbs below can omit the id.

    plm html · new
    $ cat draft.html | plm html new --name "pitch draft" --stdin
    ✓ created html "pitch draft" · now active
    html_8e02b1c4d7

    full form · plm html new [--name N] [--content "…" | --file <path|-> | --stdin]

  2. Step 2 of 3

    Read it back raw

    The body comes back exactly as stored: pipe it to a linter, diff it against a local file, or feed it to an agent. Storage, not presentation.

    plm html show
    $ plm html show

    full form · plm html show [<html_…>]

  3. Step 3 of 3

    Replace, and the browser follows

    set swaps the whole body in one write. Anyone with the file open on the Tools tab sees the preview update live, the same follow-along loop doodles have.

    plm html · set
    $ plm html set --file draft.html
    ✓ saved html_8e02b1c4d7
    html_8e02b1c4d7

    full form · plm html set [<html_…>] --content "…" | --file <path|-> | --stdin

Also in this chapter

plm html use
$ plm html use <html_…>
✓ active html: html_8e02b1c4d7
html_8e02b1c4d7

Set the active file.

plm html ls
$ plm html ls
html_8e02b1c4d7 pitch draft

Your HTML files: id and name.

plm html rename
$ plm html rename [<html_…>] <new name>
✓ renamed html_8e02b1c4d7 → "pitch v2"

Rename the file.

plm html rm
$ plm html rm <html_…>
✓ deleted html_8e02b1c4d7

Delete the file. Alias: delete.

  • These files are user-scoped and live on the dashboard's Tools tab; works from any directory, no linked repo.
  • Active file: after new or use, omit the id; an explicit html_… first argument overrides (.plmhub/state.json).
  • Add --as <label> to mutating verbs to name the agent in the live-edit bar a watcher sees.