atlas-strata 0.1.5

Intelligent code analysis tool for understanding any codebase. Analyze dependencies, risks, and architecture instantly.

Atlas Strata - Code Architecture Analysis

A pure Python CLI for analyzing codebase architecture, dependencies, and code quality.

Features

• Intelligent Code Analysis - Analyze dependencies, coupling, and architecture instantly
• Interactive Visualization - Browser-based dependency graphs with multiple layout algorithms
• LLM-Powered Insights - Ask questions about your codebase with AI reasoning (via Copilot CLI)
• Codebase Comparison - Compare two projects for architectural and structural differences
• Multiple Languages - Python, TypeScript, Java, Go, C#
• JSON Export - Integration with CI/CD and other tools
• Cross-platform - Windows, macOS, Linux

Quick Start

Installation

pip install atlas-strata
atlas --version

After installation, the atlas command will be available globally in your terminal.

Using with GitHub Copilot CLI (Recommended)

To use @atlas in GitHub Copilot CLI:

# After pip install, enable the tool once
copilot --allow-tool atlas

# Now you can use @atlas in Copilot
@atlas ask "What does the auth module do?"
@atlas analyze ./src

Direct atlas command works immediately after pip install and does not require this permission step.

Usage Examples

# Analyze codebase for dependencies and architecture
atlas analyze ./src

# Generate interactive dependency graph
atlas visualize ./src --format html

# Ask LLM about your codebase
atlas ask "What does the auth module do?" ./src

# Compare two codebases
atlas compare ./src ./backup/src

# Get JSON output for scripting
atlas analyze ./src --format json | jq

# Show detailed recommendations
atlas analyze ./src --with-recommendations

Commands

Quick Command Overview

Command	Purpose	Setup Required
atlas analyze	Analyze code dependencies and architecture	✓ Works offline
atlas visualize	Generate interactive dependency graph	✓ Works offline
atlas ask	Ask LLM about your codebase	⚠ Requires Copilot CLI
atlas compare	Compare two codebases	✓ Works offline

CLI Commands

3 Commands Work Offline (No Setup Needed)

# 1. ANALYZE - Analyze code dependencies and architecture
atlas analyze <path> [OPTIONS]
  --format json|text|mermaid    Output format (default: text)
  --with-recommendations        Show detailed refactoring insights
  --json-output PATH            Save analysis JSON to file

# 2. VISUALIZE - Generate interactive dependency graph
atlas visualize <path> [OPTIONS]
  --format html|json            Output format (default: html)
  --output DIR                  Output directory (default: ./atlas-output)

# 4. COMPARE - Compare two codebases
atlas compare <path1> <path2> [OPTIONS]
  --format json|text            Output format (default: text)
  --json-output PATH            Save comparison JSON to file

LLM-Powered Command (Requires GitHub Copilot CLI)

# 3. ASK - Ask LLM about your codebase (Requires: copilot --allow-tool atlas)
atlas ask [OPTIONS]
  "question" [path]             Query with optional path
  --interactive                 Interactive mode
  --format json|text|html       Output format

To use ask:

copilot --allow-tool atlas    # One-time setup
atlas ask "your question"     # Now works

4. COMPARE - Compare two codebases

atlas compare [OPTIONS] --format json|text Output format (default: text) --json-output PATH Save comparison JSON to file

Show help and version

atlas --help atlas --version

## License

MIT License