🚀 Syncable IaC CLI

Automatically generate optimized Docker, Kubernetes, and cloud infrastructure configurations by analyzing your codebase.

⚡ Quick Start

Syncable IaC CLI analyzes your project and automatically generates production-ready infrastructure configurations. Supporting 260+ technologies across 5 major language ecosystems, it understands your stack and creates optimized IaC files tailored to your specific needs.

⚡ Quick Start

# Install
# Install
cargo install syncable-cli

# Analyze any project

# Analyze any project
sync-ctl analyze /path/to/your/project

# Check for vulnerabilities
sync-ctl vulnerabilities

# Run security analysis
sync-ctl security

# Force update check (clears cache)
sync-ctl --clear-update-cache analyze .

That's it! The CLI will detect your languages, frameworks, dependencies, and provide detailed insights about your project structure. The tool includes smart update notifications to keep you on the latest version.

🎯 What It Does

Syncable IaC CLI is like having a DevOps expert analyze your codebase:

1. 📊 Analyzes - Detects languages, frameworks, dependencies, ports, and architecture patterns
2. 🔍 Audits - Checks for security vulnerabilities and configuration issues
3. 🚀 Generates - Creates optimized Dockerfiles, Compose files, and Terraform configs (coming soon)

Example Output

$ sync-ctl analyze ./my-express-app

═══════════════════════════════════════════════════════════════════════════════════════════════════
📊 PROJECT ANALYSIS DASHBOARD
═══════════════════════════════════════════════════════════════════════════════════════════════════

┌─ Architecture Overview ──────────────────────────────────────────────────────┐
│ Type:                                                         Single Project │
│ Pattern:                                                           Fullstack │
│ Full-stack app with frontend/backend  separation                             │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ Technology Stack ───────────────────────────────────────────────────────────┐
│ Languages:                                           JavaScript, TypeScript  │
│ Frameworks:                                    Express, React, Tailwind CSS  │
│ Databases:                                                PostgreSQL, Redis  │
└──────────────────────────────────────────────────────────────────────────────┘

📋 Key Features

🔍 Comprehensive Analysis

• Multi-language support - JavaScript/TypeScript, Python, Rust, Go, Java/Kotlin
• 260+ technologies - From React to Spring Boot, Django to Actix-web
• Architecture detection - Monolithic, microservices, serverless, and more
• Monorepo support - Analyzes complex multi-project repositories

🛡️ Security & Compliance

• Vulnerability scanning - Integrated security checks for all dependencies
• Secret detection - Finds exposed API keys and credentials
• Security scoring - Get actionable security recommendations
• Compliance checks - SOC2, GDPR, HIPAA support (coming soon)

🐳 Docker Intelligence

• Dockerfile analysis - Understand existing Docker configurations
• Multi-stage detection - Identifies build optimization patterns
• Service mapping - Traces dependencies between containers
• Network topology - Visualizes service communication

🔄 Smart Update System

• Intelligent caching - Checks every 2 hours when no update available
• Immediate notifications - Shows updates instantly when available
• Clear instructions - Provides multiple update methods with step-by-step guidance
• Zero-maintenance - Automatically keeps you informed of new releases

🛠️ Installation

Via Cargo (Recommended)

cargo install syncable-cli

From Source

git clone https://github.com/syncable-dev/syncable-cli.git
cd syncable-cli
cargo install --path .

📖 Usage Guide

Basic Commands

# Analyze with different display formats
sync-ctl analyze                    # Matrix view (default)
sync-ctl analyze --display detailed  # Detailed view
sync-ctl analyze --json             # JSON output

# Security & vulnerability checks
sync-ctl security                   # Comprehensive security analysis
sync-ctl vulnerabilities            # Dependency vulnerability scan

# Dependency analysis
sync-ctl dependencies --licenses    # Show license information
sync-ctl dependencies --vulnerabilities  # Check for known CVEs

Display Modes

Choose the output format that works best for you:

• Matrix (default) - Compact dashboard view
• Detailed - Comprehensive vertical layout
• Summary - Brief overview for CI/CD
• JSON - Machine-readable format

Advanced Configuration

Analyze with different display formats

sync-ctl analyze # Matrix view (default) sync-ctl analyze --display detailed # Detailed view sync-ctl analyze --json # JSON output

Security & vulnerability checks

sync-ctl security # Comprehensive security analysis sync-ctl vulnerabilities # Dependency vulnerability scan

Dependency analysis

sync-ctl dependencies --licenses # Show license information sync-ctl dependencies --vulnerabilities # Check for known CVEs

Advanced Configuration

Create .syncable.toml in your project root:

[analysis]
include_dev_dependencies = true
ignore_patterns = ["vendor", "node_modules", "target"]

[security]
fail_on_high_severity = true
check_secrets = true

🌟 Technology Coverage

By Language

• JavaScript/TypeScript (46) - React, Vue, Angular, Next.js, Express, Nest.js, and more
• Python (76) - Django, Flask, FastAPI, NumPy, TensorFlow, PyTorch, and more
• Java/JVM (98) - Spring Boot, Micronaut, Hibernate, Kafka, Elasticsearch, and more
• Go (21) - Gin, Echo, Fiber, gRPC, Kubernetes client, and more
• Rust (20) - Actix-web, Axum, Rocket, Tokio, SeaORM, and more

Package Managers

• npm, yarn, pnpm, bun (JavaScript)
• pip, poetry, pipenv, conda (Python)
• Maven, Gradle (Java)
• Cargo (Rust)
• Go modules (Go)

🚀 Roadmap

✅ Phase 1: Analysis Engine (Complete)

• Project analysis and technology detection
• Vulnerability scanning
• Basic security analysis

🔄 Phase 2: AI-Powered Generation (In Progress)

• Smart Dockerfile generation
• Intelligent Docker Compose creation
• Cloud-optimized configurations

📅 Future Phases

• Kubernetes manifests & Helm charts
• Terraform modules for AWS/GCP/Azure
• CI/CD pipeline generation
• Real-time monitoring setup

[security] fail_on_high_severity = true check_secrets = true

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Run tests
cargo test

# Check code quality
cargo clippy
# Check code quality
cargo clippy

# Format code
cargo fmt

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built with Rust 🦀 and powered by the open-source community.

Need help? Check our documentation or open an issue.