Dependency Graph

Visualize and explore the relationships between your packages with an interactive dependency graph.

Opening the Dependency Graph

There are several ways to open the dependency graph:

  • Press Cmd+Shift+G from anywhere in the app
  • Click View → Dependency Graph in the menu bar
  • Click the Dependencies tab in the package details panel

Understanding the Graph

The dependency graph shows how packages relate to each other:

  • Nodes - Each circle represents a package
  • Edges - Lines connect packages to their dependencies
  • Colors - Different colors indicate package types and status
  • Size - Larger nodes have more dependents

Node Colors

ColorMeaning
BlueInstalled formula
PurpleInstalled cask
AmberSelected/focused package
GrayNot installed dependency

Interacting with the Graph

Navigation

  • Pan - Click and drag on empty space to move the view
  • Zoom - Use scroll wheel or pinch gesture to zoom in/out
  • Reset View - Double-click empty space to reset zoom and position

Selecting Packages

  • Click a node - Select that package and highlight its connections
  • Double-click a node - Open the package details in the main view
  • Hover over a node - See package name and version tooltip

Graph Modes

Switch between different visualization modes:

Dependencies View

Shows what packages the selected package depends on:

  • Direct dependencies are connected with solid lines
  • Transitive dependencies are shown with dashed lines
  • Depth can be controlled with the slider

Dependents View

Shows what packages depend on the selected package:

  • Useful for understanding impact before uninstalling
  • Shows why a package was installed as a dependency

Full Graph View

Shows all installed packages and their relationships:

  • Great for understanding your overall system
  • Can be filtered by package type
  • Performance optimized for large graphs

Tip: Use the search box in the graph view to quickly find and focus on specific packages.

Graph Controls

ControlDescription
Depth SliderControl how many levels of dependencies to show (1-5)
LayoutSwitch between force-directed, hierarchical, or radial layouts
FilterShow only formulae, casks, or both
ExportSave the graph as PNG or SVG image

Layout Options

Force-Directed

Default layout where connected packages attract each other:

  • Natural clustering of related packages
  • Good for exploring relationships
  • Nodes can be dragged to rearrange

Hierarchical

Tree-like layout showing dependency levels:

  • Clear visualization of dependency depth
  • Root packages at top, dependencies below
  • Best for understanding dependency chains

Radial

Circular layout with selected package at center:

  • Dependencies radiate outward
  • Great for focused exploration
  • Compact view for many dependencies

Use Cases

Before Uninstalling

Check what depends on a package before removing it:

  1. Select the package you want to uninstall
  2. Switch to Dependents view
  3. Review which packages will be affected

Understanding Installation Size

See all transitive dependencies that will be installed:

  1. Find a package you want to install
  2. View its dependency graph
  3. Count total packages that will be added

Finding Orphaned Packages

Identify packages with no dependents:

  1. Open the full graph view
  2. Look for isolated nodes
  3. These may be candidates for cleanup