vibe-graph-cli (vg)

CLI for analyzing codebases—works with single repositories, multi-repo workspaces, or plain directories. Auto-detects structure, builds dependency graphs, and provides interactive visualization.

Installation

cargo install vibe-graph-cli

Quick Start

# Analyze current directory
vg sync

# Build the dependency graph
vg graph

# Launch interactive visualization
vg serve
# → http://localhost:3000

# Generate documentation
vg compose -o docs.md

Commands

Graph Visualization

The serve command starts a local web server with an interactive force-directed graph:

vg sync && vg serve

Build Variants

The crates.io build requires internet for D3.js. Building from source embeds all assets for offline operation.

# Install from crates.io (requires internet for D3.js)
cargo install vibe-graph-cli

# Build full version from source (offline-capable)
git clone https://github.com/pinsky-three/vibe-graph
cd vibe-graph
make build-standalone

Note: The embedded-frontend feature requires building from source because it embeds frontend/dist/ which isn't available via crates.io.

Workspace Detection

Example Session

$ cd my-project
$ vg sync
📁 Workspace: my-project
📍 Path: /home/user/my-project
🔍 Detected: single repository

✅ Sync complete
   Repositories: 1
   Total files:  142
   Total size:   1.2 MB
💾 Saved to .self/
🔗 Remote: https://github.com/user/my-project.git

$ vg status
📊 Vibe-Graph Status
──────────────────────────────────────────────────

📁 Workspace:  my-project
📍 Path:       /home/user/my-project
🔍 Type:       single repository

💾 .self:      initialized
   Last sync:  "5s ago"
   Repos:      1
   Files:      142
   Size:       1.2 MB
   Remote:     https://github.com/user/my-project.git

$ vg serve
🚀 Starting visualization server...
   Mode: D3.js (fallback)
   Graph: 156 nodes, 89 edges
📡 Open http://localhost:3000

Remote Commands (GitHub Organizations)

For workspaces (directories with multiple repos), you can configure a GitHub org:

# Set a GitHub org as the remote
vg remote add pinsky-three

# List repositories
vg remote list

# Clone all repositories from the org
vg remote clone

For single repos, the git remote is auto-detected during vg sync.

The .self Folder

Analysis results persist in .self/:

.self/
├── manifest.json   # Workspace metadata
├── project.json    # Full analysis data
├── graph.json      # SourceCodeGraph with references
└── snapshots/      # Historical snapshots (--snapshot flag)

Add .self/ to your .gitignore.

Configuration

Environment Variables

Config Commands

vg config show              # Display current config
vg config set KEY VALUE     # Set config value

Reference Detection

The graph builder detects cross-file references for:

License

MIT