devclone
One-command Docker & local development stack cloner over SSH with interactive arrow-key terminal browser.
When you develop across multiple machines, git clone only transfers source code. You still have to manually dump and restore relational databases, reconstruct Docker volumes, copy .env secrets, transfer untracked uploaded media, rebuild heavy Dockerfiles, and edit /etc/hosts.
devclone automates the entire cross-device synchronization pipeline over secure SSH. Point it at your other device, choose a project via the interactive terminal dashboard, and get a fully operational local environment—complete with databases, Docker volumes, pre-built container images, .env configs, and local domains—without ever modifying or locking the source machine.
Python 3 & Rich TUI
Zero-Touch Remote Device Safety
docker save | docker load over SSH
Production Terminal Interface & Workflows
High-resolution capture of the interactive project browser, real-time Docker container discovery, and environment status.
Interactive Arrow-Key Project Browser & Environment Monitor
Running devclone opens an interactive Rich-powered terminal dashboard. Browse remote projects with arrow keys, use / for instant fuzzy filtering by project name or technology stack, inspect live Docker container runtime states, and press Enter to clone or compare environments instantly.
How devclone Solves Cross-Device Development Bottlenecks
Everything Git ignores—databases, container volumes, custom images, .env secrets, and uploads—handled seamlessly.
Zero-Lock Database & Volume Streaming
Inspects whether the remote database container is running or stopped. Running databases are dumped live using mysqldump --single-transaction without locking tables or interrupting work. Stopped databases stream raw files via ephemeral read-only (:ro) container mounts over SSH without modifying the source machine.
Pre-Built Docker Image Streaming
If a project relies on custom-built Docker images (such as Laravel Sail or custom Dockerfiles), devclone streams the compiled images directly across SSH pipes (docker save | docker load). You never hit broken upstream package mirrors or wait 10 minutes for slow container builds.
Environment & Database Diff Engine
Instantly audit discrepancies between devices with devclone diff. Compares .env variables with automatic secret masking, inspects database tables, columns, applied migrations, exact row counts (even when database containers are stopped), and identifies missing media uploads.
Selective Targeted Data Synchronization
Once an environment is installed locally, devclone locks the project so local code changes are never overwritten. When you need fresh data, use dedicated selective commands: devclone pull-db to refresh the database, devclone pull-env to merge variables, or devclone pull-uploads for media files.
Command-Line Interface & Workflows
Flexible CLI architecture with interactive terminal prompts and automatable flags.
| Command | Description & Operation |
|---|---|
devclone |
Opens the interactive arrow-key terminal browser (Rich TUI). Browse projects, search with /, and inspect live Docker statuses. |
devclone list |
Lists all projects on the remote device, their stack type, and local installation status (supports --docker filter). |
devclone setup <project> |
Clones the complete environment: files, Docker volumes, databases, custom images, updates /etc/hosts, and starts containers. |
devclone diff <project> |
Compares .env keys, database schema/tables/rows/migrations, and media uploads between both devices. Supports --all. |
devclone pull-db <project> |
Refreshes only the database from the remote device. Completely code-safe; leaves your local Git working tree untouched. |
devclone pull-env <project> |
Interactively compares and merges missing or updated .env variables without blowing away local custom values. |
devclone pull-uploads <project> |
Syncs untracked uploads (e.g. wp-content/uploads or storage/app/public) using bandwidth-efficient rsync. |
devclone config |
Displays active SSH host, user, and path settings. Use devclone config --edit to open the configuration in your default editor. |
Zero-Touch Synchronization Architecture
How devclone moves full-stack container environments across SSH pipes without source mutations or intermediate disk bloat.
SSH Direct Streaming Pipes
Rather than writing multi-gigabyte tarball archives to the source disk and copying them over, devclone streams Docker images (docker save | docker load) and database dumps directly through compressed SSH stdout/stdin pipelines.
Port Conflict Detection & Resolution
Before booting containers, devclone inspects all active network port bindings on the local host. If a conflicting local service or container binds ports 80, 443, 3306, or 5432, it offers an interactive prompt to cleanly stop the conflicting container.
Safe One-Time Setup Lock
Once an environment is installed locally, devclone setup records the project in ~/.config/devclone/state.json and locks it. Future executions prevent accidental overwrites, directing developers to use selective data pulls instead.
Automated Local Domain Resolution
Parses the project's .env file (e.g. APP_URL=http://my-project.local) and automatically updates /etc/hosts with the required domain entries, making the cloned stack reachable in your browser immediately upon boot.
Technical Specifications
System requirements, transport protocols, and runtime dependencies.
| Primary Language | Python 3.9+ (Modular Package Architecture) |
|---|---|
| Terminal UI Framework | Rich TUI (interactive tables, spin indicators, live rendering) & Click CLI |
| Container Compatibility | Docker Engine & Docker Compose v2 (docker compose) |
| Network & Transport | OpenSSH (ssh) & rsync with Ed25519 key authentication |
| Supported Databases | MySQL 5.7/8.x, MariaDB 10.x, PostgreSQL 12-16+, SQLite3 |
| Host Operating Systems | Linux (Ubuntu, Debian, Fedora, Arch, Pop!_OS) & macOS |
| Source Safety Guarantee | 100% Read-Only on remote machine (mysqldump --single-transaction or :ro volume mounts) |
| License & Source | GNU AGPL-3.0 • github.com/stonemanhero/devclone |
Need custom Linux software, terminal tools, or system engineering?
I develop specialized terminal utilities, Docker automation tools, Python daemons, and secure developer workflows.