cxgrdcxgrd docs

cxgrd scan

Crawls your entire project directory and builds a persistent dependency graph stored in .cg/.

Usage

cxgrd scan
cxgrd scan /path/to/project
cxgrd scan --sync        # push graph to personal cloud (Pro)
cxgrd scan --team        # push graph to shared team cloud (Team)

What it creates

This command creates a .cg/ in the project directory with the following contents:

.cg/
├── graph.json      ← directed dependency graph (nodes = files, edges = imports)
├── symbols.json    ← exported functions, classes, types per file
├── arch.json       ← inferred architectural layers
├── meta.json       ← last scan time, language, entry points
├── history.json    ← change session log
└── patterns.json   ← structural patterns observed in the project

What it ignores

  • node_modules/, .venv/, venv/, dist/, .git/
  • Anything in your .gitignore

Example output

$ cxgrd scan
🔍 Scanning project...
   Path: /Users/name/project
✓ Found 22 source files
📊 Building dependency graph...
   Total dependencies: 160
   Languages: typescript(20), json(2)
✓ Scan complete!
✓ Updated .cg/ (graph, symbols, arch, patterns, memory)

Re-scanning

Run cxgrd scan anytime you add new files or change the project structure. The graph is diffed against the previous run and updated incrementally.

Options

--sync — Push the dependency graph to your personal cloud after scan (Pro plan). Enables cloud-backed blast radius and prompt enrichment.

--team — Require an active team session and push to the shared team graph (Team plan). The graph is stored under your team ID and is visible to all team members on the dashboard.

Both --sync and --team require cxgrd auth login first.

Upgrade at https://cxgrd.com/pricing