syncable-cli

Crates.iosyncable-cli
lib.rssyncable-cli
version0.34.1
created_at2025-06-05 22:52:40.095976+00
updated_at2026-01-22 23:02:37.832538+00
descriptionA Rust-based CLI that analyzes code repositories and generates Infrastructure as Code configurations
homepage
repositoryhttps://github.com/syncable-dev/syncable-cli
max_upload_size
id1702447
size10,139,383
Alex Holmberg (Alex793x)

documentation

README

Syncable

Syncable CLI

Your AI-Powered DevOps Engineer in the Terminal

CI Status Crates.io docs.rs
Downloads GitHub Stars Last Commit
License Rust 1.85+ Platform

Quick StartAI AgentFeaturesInstallationSyncable Platform →


🚀 Ready to deploy? Take your infrastructure to production with Syncable Platform — seamless cloud deployments, monitoring, and team collaboration built on top of this CLI.


What is Syncable CLI?

Stop copy-pasting Dockerfiles from Stack Overflow. Syncable CLI is an AI-powered assistant that understands your codebase and generates production-ready infrastructure — Dockerfiles, Kubernetes manifests, Terraform configs, and CI/CD pipelines — tailored specifically to your project.

Syncable CLI Demo

⚡ Quick Start

# Install
cargo install syncable-cli

# Start the AI Agent
sync-ctl chat

# Or run a quick analysis
sync-ctl analyze .

That's it. The agent analyzes your codebase, understands your stack, and helps you build infrastructure that actually works.

🤖 AI Agent

The Syncable Agent is like having a senior DevOps engineer available 24/7. It can:

Generate Infrastructure

  • Dockerfiles — Optimized multi-stage builds for any language
  • Docker Compose — Full local development environments
  • Kubernetes — Deployments, services, ingress, and more
  • Terraform — Cloud infrastructure as code
  • CI/CD — GitHub Actions, GitLab CI, Jenkins pipelines

Understand Your Code

  • Detects 260+ technologies across JavaScript, Python, Go, Rust, and Java
  • Identifies architecture patterns (monolith, microservices, serverless)
  • Maps service dependencies and port configurations
  • Reads your existing configs and improves them

🔌 VS Code Integration (Recommended)

For the best experience, install the Syncable IDE Companion extension:

code --install-extension syncable.syncable-ide-companion

This enables:

  • Native diff views — Review file changes side-by-side in VS Code
  • One-click accept/reject — Accept with Cmd+S or reject changes easily
  • Auto-detection — Works automatically when running sync-ctl chat in VS Code's terminal

Without the extension, the agent still works but shows diffs in the terminal instead.

Chat Commands

Command Description
/model Switch AI model (GPT-4, Claude, etc.)
/provider Switch between OpenAI and Anthropic
/clear Clear conversation history
/help Show available commands

Keyboard Shortcuts

Shortcut Action
Ctrl+J Insert newline (multi-line input)
Shift+Enter Insert newline
@filename Add file to context
Ctrl+C Cancel / Exit

🔍 Features

Project Analysis

sync-ctl analyze .

Get a complete breakdown of your project — languages, frameworks, databases, ports, and architecture patterns.

Security Scanning

sync-ctl security

Blazing-fast secret detection powered by Rust. Finds API keys, tokens, and credentials in seconds, not minutes.

Mode Speed Use Case
--mode lightning 🚀 Fastest Pre-commit hooks
--mode fast ⚡ Fast Development
--mode thorough 🔍 Complete Security audits
--mode paranoid 🕵️ Maximum Compliance

Vulnerability Checking

sync-ctl vulnerabilities

Scan your dependencies for known CVEs across npm, pip, cargo, and more.

📦 Installation

Cargo (Recommended)

cargo install syncable-cli

Linux/macOS

curl -sSL https://install.syncable.dev | sh

Windows

iwr -useb https://raw.githubusercontent.com/syncable-dev/syncable-cli/main/install.ps1 | iex

From Source

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

🔧 Configuration

AI Provider Setup

# OpenAI
export OPENAI_API_KEY="sk-..."

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

Project Config (.syncable.toml)

[agent]
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"

[security]
default_mode = "thorough"
fail_on_high_severity = true

[analysis]
ignore_patterns = ["node_modules", "target", "dist"]

🌟 Supported Technologies

260+ technologies across 5 ecosystems

JavaScript/TypeScript — React, Vue, Angular, Next.js, Express, Nest.js, Fastify, and 40+ more

Python — Django, Flask, FastAPI, Celery, NumPy, TensorFlow, PyTorch, and 70+ more

Go — Gin, Echo, Fiber, gRPC, Kubernetes client, and 20+ more

Rust — Actix-web, Axum, Rocket, Tokio, SeaORM, and 20+ more

Java/Kotlin — Spring Boot, Micronaut, Quarkus, Hibernate, and 90+ more

🚀 What's Next?

This CLI is the foundation of the Syncable Platform — a complete DevOps solution that takes you from code to production:

  • One-click deployments to AWS, GCP, or Azure
  • Team collaboration with shared environments
  • Monitoring & logs built-in
  • Cost optimization recommendations

Get started at syncable.dev →

🤝 Contributing

We love contributions! Whether it's bug fixes, new features, or documentation improvements.

# Clone and build
git clone https://github.com/syncable-dev/syncable-cli.git
cd syncable-cli
cargo build

# Run tests
cargo test

# Check code quality
cargo clippy && cargo fmt

See CONTRIBUTING.md for detailed guidelines.

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

See LICENSE for the full license text.

Third-Party Attributions

The Dockerfile linting functionality (src/analyzer/hadolint/) is a Rust translation of Hadolint, originally written in Haskell by Lukas Martinelli and contributors.

The Docker Compose linting functionality (src/analyzer/dclint/) is a Rust implementation inspired by docker-compose-linter by Sergey Suspended.

See THIRD_PARTY_NOTICES.md for full attribution details.


Built with 🦀 Rust
GitHubWebsiteIssues

GitHub stars

Commit count: 656

cargo fmt