Skip to content

vizzy workspaces

A workspace is a named set of folders that one window watches. Each Vizzy window is bound to its own workspace, so you can keep, say, a “Frontend” window watching a couple of repos and a separate “Infra” window watching others — each with its own sidebar of discovered diagrams.

When no workspace window is open, Vizzy shows a launcher — a window listing your workspaces (and the git repos it has auto-discovered) so you can jump straight to the folders you work with. Open a workspace to get a full document window with its sidebar.

  • File ▸ New Workspace opens a fresh workspace in its own window.
  • Add the folders you want that window to watch; Vizzy scans them for vizzy/*.vizzy.md files and lists what it finds in the sidebar, marking which folders are git repos.
  • Each workspace remembers its own folders and display preferences (such as whether Markdown files are shown and which items are pinned), so windows stay independent.

Auto-discovery still works as before — Vizzy watches your folders and updates the sidebar live as diagram files appear, change, or are removed (see the introduction for where diagram files live).