ArcVision CLI

Architecture scanner for modern codebases that generates dependency graphs and visualizes your project structure.

Installation

npm install -g arcvision

Usage

Quick Start

1. Sign up at the ArcVision dashboard
2. Create a project and name it
3. Generate a CLI token
4. Run: arcvision link <token>
5. Run: arcvision scan --upload
6. Open dashboard to see results

Commands

Link to Project

arcvision link <token>

Link this CLI to a project via upload token.

Scan Project

arcvision scan [directory] [options]

Scan the current directory and generate architecture map.

Options:

• -u, --upload: Upload to database

The scan command will also output a blast radius analysis showing the file with the highest blast radius and its potential impact on your codebase.

Blast Radius Analysis: After scanning, the CLI will display a warning identifying the most critical file in your codebase:

⚠️ [filename] at the center of the system (blast radius: X out of Y). This file represents a single point of systemic failure. Changes here may affect many parts of the system.

This feature helps identify high-risk files that are imported by many other files, allowing you to be more cautious when modifying them.

Features

• Modern Import Resolution: Handles path aliases (@/components/*), barrel files (./utils → ./utils/index.ts), and directory imports
• AST-based Parsing: Uses Babel parser for accurate import detection
• Multi-framework Support: Works with React, Next.js, and other modern JavaScript frameworks
• Dependency Graph Generation: Creates comprehensive node-edge relationships
• Blast Radius Analysis: Identifies high-risk files that are imported by many other files
• Cloud Integration: Uploads results to ArcVision dashboard for visualization

Supported Import Patterns

• Relative imports: ./utils, ../components
• Path aliases: @/components/Button, ~/lib/utils
• Barrel files: ./utils resolves to ./utils/index.ts(x)
• Directory imports: @/utils resolves to src/utils/index.ts(x)
• Implicit extensions: .ts, .tsx, .js, .jsx

Architecture

The ArcVision CLI runs locally on your machine and:

1. Scans your project files using AST parsing
2. Detects import relationships between files
3. Resolves path aliases using tsconfig.json/jsconfig.json
4. Generates a dependency graph in JSON format
5. Uploads the graph to the ArcVision dashboard via API

License

MIT