syncable-dev/syncable-cli

Syncable CLI

DevOps toolbox for AI coding agents and developers

Quick Start • AI Agent Skills • Commands • Installation • Syncable Platform →

---

What is Syncable CLI?

Syncable CLI (sync-ctl) is a DevOps toolbox that analyzes codebases, scans for security issues, validates infrastructure files, and deploys to cloud providers. It works standalone from the terminal or through AI coding agent skills — giving Claude Code, Codex, Gemini CLI, Cursor, and Windsurf the ability to run security scans, check for CVEs, lint Dockerfiles, and deploy services through natural conversation.

⚡ Quick Start

For AI coding agents (recommended)

npx syncable-cli-skills

This installs 11 skills (7 command + 4 workflow) into your AI coding agent. Then just ask:

• “assess this project” — full health check
• “scan for security issues” — secrets and credential detection
• “check for vulnerabilities” — CVE scanning across all dependencies
• “validate my Dockerfiles” — lint IaC files
• “deploy this service” — cloud deployment with preview

For direct CLI use

cargo install syncable-cli
sync-ctl analyze .

# Generate a CI pipeline skeleton (GitHub Actions, Azure Pipelines, or Cloud Build)
sync-ctl generate ci . --platform gcp --dry-run   # preview without writing files
sync-ctl generate ci . --platform azure            # write azure-pipelines.yml
sync-ctl generate ci . --platform hetzner --notify # with Slack failure alert

# Generate a CD pipeline skeleton
sync-ctl generate cd . --platform gcp --target cloud-run --dry-run
sync-ctl generate cd . --platform azure --target aks -o ./pipelines
sync-ctl generate cd . --platform hetzner --target vps --notify

# Generate both CI + CD in one shot
sync-ctl generate ci-cd . --platform gcp --target cloud-run --dry-run
sync-ctl generate ci-cd . --platform hetzner --target vps --notify

🤖 AI Agent Skills

One command installs skills for all major AI coding agents:

npx syncable-cli-skills

What the skills teach your agent

Command skills — atomic wrappers around sync-ctl commands:

Workflow skills — multi-step orchestrations with decision logic:

How it works

Skills teach your AI agent to use sync-ctl with the --agent flag, which outputs compressed JSON instead of terminal formatting. The agent gets a summary with the key findings, plus a reference ID to retrieve full details on demand:

# Agent runs this (compressed output, ~2KB)
sync-ctl security . --mode balanced --agent

# Agent drills into details only when needed (paginated)
sync-ctl retrieve  --query "severity:critical" --limit 10

This keeps the agent’s context window small while giving access to the full data.

🔍 Commands

Project Analysis

sync-ctl analyze .                    # Human-readable matrix view
sync-ctl analyze . --agent            # Compressed JSON for agents

Detects 260+ technologies across JavaScript, Python, Go, Rust, and Java ecosystems.

Security Scanning

sync-ctl security . --mode balanced   # Standard scan
sync-ctl security . --mode paranoid   # Deep compliance audit

Vulnerability Detection

sync-ctl vulnerabilities .            # Scan all dependencies for CVEs
sync-ctl vulnerabilities . --severity high  # Only high+ severity

Scans npm, pip, cargo, go, and Java dependencies. Automatically discovers and scans all subdirectories in monorepos.

IaC Validation

sync-ctl validate .                   # Lint all IaC files
sync-ctl validate . --types dockerfile,compose  # Specific types
sync-ctl validate . --types compose --fix       # Auto-fix issues

Deployment

sync-ctl deploy preview .             # Get deployment recommendation (JSON)
sync-ctl deploy run . --provider hetzner --port 8080 --public  # Deploy
sync-ctl deploy status  --watch  # Monitor progress
sync-ctl deploy wizard                # Interactive wizard (for humans)

Platform Management

sync-ctl auth login                   # Authenticate with Syncable
sync-ctl project current              # Show current context
sync-ctl org list                     # List organizations
sync-ctl project select           # Switch project
sync-ctl env select staging           # Switch environment

📦 Installation

Cargo (recommended)

cargo install syncable-cli

From source

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

🌟 Supported Technologies

🚀 Syncable Platform

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, Hetzner, 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.

git clone https://github.com/syncable-dev/syncable-cli.git
cd syncable-cli
cargo build
cargo test
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 dclint by Sergey Kupletsky.

The Kubernetes manifest linting functionality (src/analyzer/kubelint/) is a Rust reimplementation inspired by KubeLinter by StackRox / Red Hat.

The Helm chart linting functionality (src/analyzer/helmlint/) is a Rust implementation inspired by the official Helm lint command.