Syncable CLI

Your AI-Powered DevOps Engineer in the Terminal

Quick Start • AI Agent • Features • Installation • Syncable 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.

⚡ 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
GitHub • Website • Issues