pi-svw-waveform

Pi package for native svw waveform inspection and terminal rendering

Packages

Package details

extensionskill

Install pi-svw-waveform from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-svw-waveform

Package: pi-svw-waveform
Version: 0.1.13
Published: Sep 10, 2026
Downloads: 1,711/mo · 211/wk
Author: svcomplex-dev
License: MIT
Types: extension, skill
Size: 53.4 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/index.ts"
  ],
  "skills": [
    "./skills"
  ],
  "image": "https://raw.githubusercontent.com/svcomplex-dev/svw/main/features-pi-agent.gif"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-svw-waveform

A Pi package that installs the public svw binary, loads the svw-waveform Skill, and registers the native svw_wave_render terminal tool.

Install

pi install npm:pi-svw-waveform

Until the first npm release is published, the same package can be installed directly from GitHub:

pi install git:github.com/svcomplex-dev/pi-svw-waveform

Pi records the package in ~/.pi/agent/settings.json and loads both the Skill and extension on subsequent runs.

What installation does

The package bootstrap is intentionally platform-specific. Published package versions pin the immutable release-X.Y.Z that triggered their publication:

Linux x64 downloads the pinned public GitHub Release archive and checksum, verifies SHA-256 through the audited svw installer, and keeps the installation inside this Pi package.
Apple Silicon macOS installs or upgrades the matching versioned Formula from svcomplex-dev/tap through Homebrew, then verifies svw --version.
Other platforms fail explicitly.

Set SVW_PI_VERSION=latest to override the packaged release, or set SVW_PI_VERSION=0.1.0 while installing to select another immutable release-0.1.0 artifact. Set SVW_PI_SKIP_INSTALL=1 only when reviewing the package or when a compatible svw is already supplied through SVW_BIN.

Pi packages execute with full user privileges. Review this repository, especially scripts/install-svw.mjs and scripts/install-svw.sh, before installation.

Use

Ask Pi to inspect a VCD or FST waveform. The bundled Skill guides bounded metadata, signal, value, change, comparison, and render queries. The extension's svw_wave_render tool displays a complete colored waveform in Pi's terminal without duplicating the canvas into model context.

Override binary discovery only when required:

SVW_BIN=/absolute/path/to/svw pi

Development

scripts/setup-git-hooks.sh
SVW_PI_SKIP_INSTALL=1 npm install
npm run verify
npm run smoke:pi

All repository commits must use code@svcomplex.ai for both author and committer identities. The tracked hooks and GitHub identity workflow enforce this policy.

Publishing

Tags named vX.Y.Z publish the matching package version to npm. A trusted svw-release-published repository dispatch also advances the package patch, pins that svw release, runs the package gates, and publishes through npm OIDC. The pi-package keyword makes the npm release discoverable in the Pi package gallery; no persistent npm publishing token is used.

License

MIT