cxgrd
What is CXGRD?
Modern codebases are deeply interconnected — changing one file can silently break a dozen others. When you ask an AI assistant to refactor a service or add a feature, it typically has no awareness of your project's dependency graph, architectural layers, or downstream impact.
CXGRD solves this. It scans your project and builds a complete dependency graph, then uses that graph to:
- Tell you exactly what will break before you make a change
- Enrich your AI prompts with architectural context so the AI makes safer, smarter suggestions
- Validate your code for circular dependencies, orphaned files, and layer violations — both structurally and with compiler-backed checks
- Enforce merge policies on pull requests via GitHub Actions, blocking merges that exceed your team's blast radius limits
Think of it as giving your AI assistant a map of your codebase before it starts digging.
Typical Workflow
# 1. Authenticate
cxgrd auth login
# Required for Pro, Team and Enterprise plans
# 2. Scan your project
cxgrd scan
# 3. Before making a change — check the blast radius
cxgrd input "extract UserService into a separate module"
# 4. Generate an enriched prompt for your AI
cxgrd prompt "extract UserService into a separate module"
# 5. Paste the prompt into your AI tool, make the changes
# 6. Validate the result
cxgrd check
Core Commands
| Command | Description |
|---|---|
cxgrd scan | Build dependency graph, write to .cg/ |
cxgrd scan --team | Scan and push graph to shared team cloud (Team plan) |
cxgrd scan --sync | Scan and push graph to personal cloud (Pro plan) |
cxgrd input "change" | Compute blast radius of a planned change |
cxgrd prompt "change" | Generate architecture-aware AI prompt (Pro) |
cxgrd check | Compiler-backed verification of AI diffs |
cxgrd check --ci | CI mode: post result to server for GitHub PR status (Team plan) |
cxgrd auth login | Sign in for Pro/Team features |
cxgrd doctor | Check toolchain readiness |
Plans
| Feature | Free | Pro | Team |
|---|---|---|---|
Dependency graph (scan) | ✓ | ✓ | ✓ |
Blast radius (input) | ✓ | ✓ | ✓ |
Compiler checks (check) | ✓ | ✓ | ✓ |
AI prompt enrichment (prompt) | — | ✓ | ✓ |
Cloud graph sync (--sync) | — | ✓ | ✓ |
Team graph (--team) | — | — | ✓ |
CI merge enforcement (--ci) | — | — | ✓ |
| Merge policies | — | — | ✓ |
| Team dashboard | — | — | ✓ |
| Audit log | — | — | ✓ |
Quick Start
npm install -g cxgrd
cd your-project
cxgrd scan
cxgrd input "add rate limiting to auth middleware"
Upgrade at https://cxgrd.com/pricing