Render Graphviz DOT

This command renders an existing DOT file into an actual image output using Graphviz on the local machine.

Use it after export-graphviz-dot when you want something directly viewable like SVG or PNG.

Command

Default render:

dotnet run --project NEXUS-Code/src/Nexus.Cli/Nexus.Cli.fsproj -- \
  render-graphviz-dot \
  --input NEXUS-EventStore/graph/exports/nexus-graph.dot

Explicit engine and format:

dotnet run --project NEXUS-Code/src/Nexus.Cli/Nexus.Cli.fsproj -- \
  render-graphviz-dot \
  --input NEXUS-EventStore/graph/exports/nexus-graph__provider-codex.dot \
  --engine sfdp \
  --format svg

PNG output:

dotnet run --project NEXUS-Code/src/Nexus.Cli/Nexus.Cli.fsproj -- \
  render-graphviz-dot \
  --input /tmp/nexus-graph.dot \
  --output /tmp/nexus-graph.png \
  --format png

Output root with generated file name:

dotnet run --project NEXUS-Code/src/Nexus.Cli/Nexus.Cli.fsproj -- \
  render-graphviz-dot \
  --input /tmp/nexus-graph.dot \
  --output-root /tmp/nexus-rendered

Allowed Values

Engines:

  • dot
  • sfdp

Formats:

  • svg
  • png

These are intentionally explicit allowlists.

Defaults

  • engine: dot
  • format: svg
  • output path: the input DOT path with the selected format extension
  • output root: if supplied, NEXUS keeps the generated file name and writes it under that directory

Notes

  • This command renders an existing DOT file. It does not generate the DOT source.
  • Use export-graphviz-dot first if you still need to create the DOT file.
  • sfdp is often a better layout choice for larger or more organic graph slices.
  • Use either --output or --output-root, not both.