atlas-strata 0.1.2

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 - Build dependency graphs automatically
• Architecture Understanding - Identify coupling, cycles, dead code, impact analysis
• Health Scoring - Rate architecture quality and surface issues
• Dependency Visualization - Interactive browser-based graphs
• 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

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

Usage Examples

# Quick analysis
atlas analyze .

# Generate interactive graph
atlas visualize . --format html

# Check code health
atlas health .

# Find circular dependencies
atlas health cycles .

# Detect dead code
atlas health dead-code .

# Query dependency paths
atlas query --from auth.py --to main.py .

# Get JSON output
atlas analyze . --format json

Commands

Standalone CLI

# Analyze directory
atlas analyze <path> [--format json|text|mermaid]

# Generate health report
atlas report <path>
atlas health <path>

# Visualize dependency graph
atlas visualize <path> [--format html|json] [--output FILE]

# Query dependencies
atlas query --from <source> --to <target> <path>

# Show help
atlas --help

Running Tests

# Run full test suite
pytest tests/

# Run specific tests
pytest tests/test_cli.py -v

# With coverage
pytest --cov=agent tests/

Expected: 159+ tests passing

Architecture

Atlas uses a pure Python architecture:

• Core Modules: agent/atlas/core/ - Analysis engines (Analyzer, QueryEngine, Visualizer, Formatters)
• Existing Analysis Infrastructure: Reuses all existing analyzers (BlastRadius, DeadCode, Cycles, Coupling, Health)
• CLI Layer: agent/cli.py - Command-line interface using Click
• No Internal LLM: All LLM reasoning handled by Copilot CLI

No External Dependencies for LLM

• ✅ No GitHub Copilot SDK imports
• ✅ No direct API calls
• ✅ No hardcoded credentials
• ✅ Pure JSON output to stdout
• ✅ Copilot CLI manages all LLM authentication

Documentation

See the docs/ and site/ directories for detailed documentation.

Development

See CONTRIBUTING.md for contribution guidelines. Requires Python 3.12+.

License

MIT License