IWE Export

Exports graph structure in various formats for visualization and analysis.

Usage

iwe export [OPTIONS] <FORMAT>

Available Formats

FormatDescription
dotGraphviz DOT format for graph visualization

Options

OptionDefaultDescription
-k, --key <KEY>all rootsFilter to specific document and its connections
-d, --depth <DEPTH>0Maximum depth to include (0 = unlimited)
--include-headersfalseInclude section headers and create detailed subgraphs
-v, --verbose <LEVEL>0Verbosity level

DOT Output Format

The DOT format produces Graphviz-compatible output:

digraph G {
  rankdir="LR"
  fontname="Verdana"
  fontsize="13"
  nodesep="0.7"
  splines="polyline"
  pad="0.5,0.2"
  ranksep="1.2"
  overlap="false"
  0 [label="Project Overview" fillcolor="#e8f0e8" fontsize="24" fontname="Verdana" color="#b3b3b3" penwidth="1.5" shape="note" style="filled"]
  1 [label="Goals" fillcolor="#e8f0e8" fontsize="16" fontname="Verdana" color="#b3b3b3" penwidth="1.5" shape="note" style="filled"]
  2 [label="Architecture" fillcolor="#e8f0e8" fontsize="16" fontname="Verdana" color="#b3b3b3" penwidth="1.5" shape="note" style="filled"]
  0 -> 1 [color="#38546c66" arrowhead="normal" penwidth="1.2"]
  0 -> 2 [color="#38546c66" arrowhead="normal" penwidth="1.2"]
}

Nodes represent documents, edges represent links between them.

Examples

# Export entire graph
iwe export dot

# Export specific document and connections
iwe export dot --key "project-main"

# Include section headers for detailed view
iwe export dot --include-headers

# Export with depth limit
iwe export dot --key "research" --depth 3

# Export with headers and depth limit
iwe export dot --key "research" --depth 3 --include-headers

Generating Images

# Generate PNG visualization
iwe export dot > graph.dot
dot -Tpng graph.dot -o graph.png

# Generate SVG for web use
iwe export dot --include-headers > detailed.dot
dot -Tsvg detailed.dot -o detailed.svg

# Direct to PNG (one-liner)
iwe export dot | dot -Tpng -o graph.png

# Interactive visualization in browser
iwe export dot | dot -Tsvg > graph.svg && open graph.svg

Depth Behavior

DepthBehavior
0Unlimited - include all reachable documents
1Only the specified document
2Document and its direct links
3+Document and N-1 levels of connections

With vs Without Headers

ModeUse Case
Without --include-headersHigh-level document relationships
With --include-headersDetailed view showing internal sections

AI Agent Tips

  • Use export dot to analyze document relationship topology
  • Generate visualizations to identify disconnected clusters
  • Use --depth to focus on specific neighborhoods in large graphs
  • Combine with --key to visualize a single topic and its context
  • The graph structure reveals how knowledge is organized and connected