Skip to content
pi-better-show

Install

pi-better-show is a pi package. One command adds the show_doc tool.

Terminal window
pi install npm:pi-better-show

Then /reload in a running session.

Requirements

Section titled “Requirements”
  • pi, the coding agent that loads the package.
  • A default browser for view: "page", and an editor for view: "edit" (VS Code, or the one PI_BETTER_SHOW_EDITOR names).
Replacing pi-herdr-doc-review

If you use pi-herdr-doc-review, uninstall it first (pi uninstall npm:pi-herdr-doc-review): both register show_doc, so only one may load. show_doc keeps its name and parameters; Herdr panes, terminal editors, and the <pi-*> page-kit tags are gone. The reference lists what changed.

Without pi

The block vocabulary is a library too: npm install pi-better-show gives a host core (pi-better-show), custom elements (pi-better-show/elements), React wrappers (pi-better-show/react), and Mermaid drawing (pi-better-show/server). Hosts shows how a host puts them together.

The package ships TypeScript source with no build step, so it loads under Node’s type stripping, in Bun, and in bundler pipelines.

Next

Section titled “Next”