CLI focus and app control

Beyond rendering and linting, the vizzy CLI can drive an already-running app — handy when a coding agent wants to walk you through a diagram on screen, or read back what a window is currently showing. Each command acts on the focused window (or the window tied to the terminal you’re running in).

These commands talk to a running Vizzy, so open one first with vizzy (or vizzy <file>) — see the Introduction to install the CLI.

focus — centre on a node

vizzy focus <nodeId|groupId> [--zoom N] [--no-pulse]

Pans and zooms the canvas to centre on a node or group, then pulses a highlight so it’s easy to spot. Pass --zoom to set the zoom level, or --no-pulse to skip the highlight animation.

vizzy focus auth-service                      # centre on the node and pulse it
vizzy focus auth-service --zoom 1.5 --no-pulse

goto — switch documents

vizzy goto <document>

Switches the focused window to another document, by name or path.

vizzy goto checkout                 # match an open doc by name
vizzy goto vizzy/checkout.vizzy.md  # or by path

open-hint — open a node’s hint

vizzy open-hint <nodeId>

Opens the (?) hint window attached to a node — the same panel a reader sees when they click the node’s hint badge.

comment — manage review comments

vizzy comment delete <number>

Deletes a review comment by its number (the one shown on its pin).

state — read what’s on screen

vizzy state

Prints what the focused window is currently showing as JSON — the open document and what’s in view. Useful for an agent to orient itself before issuing a focus or goto:

vizzy state | jq .