html-long-answer

Make long assistant answers exportable as designed HTML in both Oh My Pi / OMP and legacy Pi.

Why this exists

Long answers are useful, but they are not always pleasant to read inside the terminal. This extension captures long assistant replies, keeps them available for later export, and lets you turn them into browser-opened HTML in one step.

It is built for two workflows:

• fast local HTML when you just want a readable artifact now
• richer designed HTML when you want a second-pass render via the current Pi model or Gemini CLI

What users should look for

The extension does not interrupt or replace the end of a long answer.

Instead it:

1. lets the assistant answer finish normally in the terminal
2. captures the answer into session state
3. waits for the user to run /html-last
4. writes and opens the HTML artifact in the default browser

Render modes

| Mode | What it does | Best for | |---|---|---| | local | Fast local render with a designed shell, outline rail, excerpt hero, and clickable links | Speed and reliability | | pi | Uses the current Pi model for a richer second-pass HTML render | Staying in the current session/model context | | gemini | Uses Gemini CLI for a richer external render; falls back to local HTML if valid HTML is not returned | Maximum polish when Gemini is available |

Commands

| Command | Result | |---|---| | /html-last | Opens quick local HTML without starting a Pi model turn | | /html-last choose | Opens a render-mode chooser | | /html-last local | Forces quick local HTML | | /html-last pi | Forces designed HTML via the current Pi model | | /html-last gemini | Forces designed HTML via Gemini CLI | | /html-last-version | Shows the loaded extension version |

Quick start

Native Pi npm install:

pi install npm:pi-html-long-answer-extension

Native Pi git install:

pi install git:https://github.com/zakelfassi/pi-html-long-answer-extension.git

Oh My Pi / OMP global install:

mkdir -p ~/.omp/agent/extensions
git clone https://github.com/zakelfassi/pi-html-long-answer-extension.git \
  ~/.omp/agent/extensions/html-long-answer

Then ask for a long answer and run:

/html-last-version
/html-last local

Installation and compatibility matrix

This package is published to npm for Pi package discovery and remains installable directly from git for pinned or source-reviewed installs.

| Harness / platform | Install or load path | Verify after install | Expected result | Status | |---|---|---|---|---| | Native Pi npm package | pi install npm:pi-html-long-answer-extension | Run /html-last-version, then /html-last local after a long answer | Version notification, then a browser-opened local HTML export | Supported package path; appears in npm-backed Pi package discovery | | Native / legacy Pi git | pi install git:https://github.com/zakelfassi/pi-html-long-answer-extension.git | Run /html-last-version, then /html-last local after a long answer | Version notification, then a browser-opened local HTML export | Supported source install path; verify on your installed Pi version | | Manual Pi extension root | Clone to ~/.pi/agent/extensions/html-long-answer | Restart/load Pi, then run /html-last-version and /html-last local | Extension auto-loads from the global root | Supported path; verify on your installed Pi version | | Oh My Pi / OMP | Clone to ~/.omp/agent/extensions/html-long-answer | Restart/load OMP, then run /html-last-version and /html-last local | Extension auto-loads from the OMP global root | Supported path; verify on your installed OMP version | | OMP one-off test | omp -e /absolute/path/to/index.js | Run /html-last-version | Version notification appears | Supported one-off smoke path | | Pi-compatible derived harnesses | Use the Pi npm/git/manual instructions if the harness honors Pi package.json.pi.extensions or Pi extension roots | Run /html-last-version and /html-last local | Same command behavior as Pi | Harness-specific commands are unverified | | Gemini CLI | Optional external renderer used by /html-last gemini | Run /html-last gemini after a long answer | Designed HTML export, or a clean fallback to local HTML if Gemini is unavailable/invalid | Optional |

Verify after install

| Command | Expected result | |---|---| | /html-last-version | Shows the loaded html-long-answer version | | /html-last | Writes a local HTML artifact and opens it in the default browser without starting a Pi model turn | | /html-last choose | Opens the render-mode chooser when UI selection is available | | /html-last local | Writes a local HTML artifact and opens it in the default browser | | /html-last pi | Queues a current-model designed HTML pass, then writes the result or falls back safely | | /html-last gemini | Uses Gemini CLI when available; invalid/unsafe/non-HTML output falls back to local HTML |

For reproducible installs, pin an npm version or a git ref/tag once you choose a release:

pi install npm:[email protected]
pi install git:https://github.com/zakelfassi/[email protected]

Runtime behavior

• Long answers are detected from message length / line / paragraph thresholds.
• Long answers are captured into session state so /html-last can work on prior assistant replies.
• Local and designed exports open automatically in the browser after the file is written.
• Raw URLs such as https://example.com are linkified in local exports.
• Rich Pi/Gemini renders must be standalone HTML documents with inline CSS only.
• Rich HTML is validated before writing: scripts, event-handler attributes, javascript: URLs, external assets, external CSS URLs, unsafe tags, oversized output, and overly complex output are rejected or routed to fallback behavior.
• Invalid, unsafe, or non-HTML rich output falls back to the local renderer instead of writing a malformed nested document.

Repo layout

html-long-answer/
├── .github/
│   └── workflows/
│       └── ci.yml
├── assets/
│   ├── flow.svg
│   ├── hero.svg
│   └── render-modes.svg
├── test/
│   └── extension.test.js
├── index.js
├── package.json
├── pnpm-lock.yaml
├── README.md
└── .gitignore

Development notes

The extension runtime still lives in a single file (index.js) so it is easy to install directly into a Pi or OMP extension root. Tests and CI live outside the runtime path.

Use PNPM:

pnpm install
pnpm test

If you modify it, re-test these flows:

• long answer -> answer remains visible; no automatic replacement notice appears
• /html-last -> local HTML writes and opens without starting a Pi model turn
• /html-last choose -> chooser appears
• /html-last local -> HTML writes and opens
• /html-last pi -> second-pass render path queues/runs and validates rich HTML
• /html-last gemini -> Gemini render path succeeds or cleanly falls back
• /html-last-version -> version shown in-session

Trust and security

Extensions run with your user permissions. Only install from sources you trust, review the source before installing, and pin a git ref or tag when you need reproducible behavior.

Rich HTML generated by Pi or Gemini is treated as untrusted until it passes this extension's validation. The validator is intentionally conservative: if rich output includes active scripts, event handlers, external assets, or unsafe URLs, the extension falls back to local HTML rather than writing the rich document.