Desktop Software Terminal CLI & TUI Docker & Systems

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.

devclone Icon

Python 3 & Rich TUI

Zero-Touch Remote Device Safety

1 Command
Full Stack Environment Clone
100% Read-Only
Zero Remote Device Mutations
Core Capabilities:
🔵 Live & Stopped Databases: mysqldump on running DBs or read-only volume streams
🟢 Image Streaming: Pipes docker save | docker load over SSH
🟡 Differential Inspector: Compares .env, schemas, rows, and media
🔴 Setup Lock Protection: Prevents overwriting local code branches
Open Source: Released under GNU AGPL-3.0 License.

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.

1

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.

2

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.

3

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.

4

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.

Inquire About Systems Development