Recorded live in real svw sessions — search, groups, markers, interval zoom, reports and theme switching.
Fast, focused waveform debugging for people and AI agents, right in the terminal.
Install me macOS (Apple silicon) · Linux (x86_64)svw is an interactive digital waveform viewer that runs entirely in your terminal. Point it at a simulation dump and debug right where you already work — over SSH, inside CI containers, or next to your editor — with the same focused workflow.
Open VCD, EVCD and FST waveforms without extra setup. Read digital and real-valued signals clearly, then move through the design with familiar commands, search, markers and shortcuts.
Work naturally in local shells, SSH sessions and containers. Crisp waveform graphics, responsive interaction, mouse controls and colors adapt smoothly to the terminal at hand.
Modal keymaps, a : command line, a fuzzy signal picker
with live waveform preview, and a discoverable leader menu keep common
actions close at hand.
Use repeatable command workflows, focused JSON/TUI queries and connected agent sessions. Pi Agent integration is included with the installation.
Diff two dumps on an exact shared timeline, generate switching activity, value, transaction and assertion reports, and load UCIS coverage — all without leaving the terminal.
Install the latest svw release with one command. Currently supported: macOS (Apple silicon) and Linux (x86_64).
$ curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/svcomplex-dev/svw/main/install.sh | sh
Then open any waveform:
svw wave.vcd # or wave.fst — format auto-detected
svw --headless wave.vcd < script.svwcmd # scriptable, CI-friendlyThe installation also includes agent workflows, configuration examples and the Pi Agent integration.
For the clearest display, use a modern monospaced terminal font with broad symbol coverage. The recordings use the same recommended setup.
svw treats AI coding assistants as first-class users. They can inspect waveform context and return concise JSON or visual TUI evidence for review.
# one-shot JSON or TUI evidence, composable from any shell
svw agent wave.fst info
svw agent wave.fst signals clk 10
svw agent wave.fst render 0 200 top.clk top.state --color ansi --view wave
# connected agent session
svw mcp wave.fstAgents can search signals, inspect values and changes, compare results and return bounded evidence. Pi Agent integration adds a full-color waveform view alongside the result — see the AI agents page.
Two tracks, depending on who is driving the terminal.
The command tutorial documents every
: command — signals, markers, zoom, search, expressions,
virtual buses, coverage, simulator control — each with a copy-pasteable
snippet and a recorded terminal demo played in the browser.
The agent guide covers the scriptable
--headless mode and the svw agent one-shot
JSON/TUI query CLI — the interfaces intended for coding agents and
automated jobs.