CLI focus and app control

The vizzy CLI can also control a running app. This is useful when a coding agent wants to walk you through a diagram on screen, or read back what a window is showing. Each command acts on the focused window, or the window tied to the terminal you are running in.

These commands need 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. 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

A path outside the current workspace opens the right workspace for it (since 0.0.11). An already-open window covering the file is focused. Otherwise an existing workspace from your library is reopened. If neither exists, a new workspace is created, scoped to and named after the file’s git repo. Relative paths resolve against your terminal’s working directory, so an agent can create a doc anywhere and vizzy goto it in one step.

open-hint: open a node’s hint

vizzy open-hint <nodeId>

Opens the (i) hint window attached to a node. This is 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 is on screen

vizzy state

Prints what the focused window is showing as JSON: the open document and what is in view. An agent can use this to orient itself before running focus or goto:

vizzy state | jq .