Repo brief: EugenMayer/docker-sync

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T13:50:08.403Z · commit 4eab6de164d4

Verdict

Mixed — Slowing — last commit 5mo ago

• Last commit 5mo ago
• 31+ active contributors
• GPL-3.0 licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

docker-sync is a Ruby CLI tool that synchronizes code changes between your local filesystem and Docker containers in real-time on macOS, Windows, and Linux. It solves the performance problem where Docker bind mounts are slow on non-Linux hosts by using native filesystem watchers and optimized sync strategies (unison, rsync, native) to keep container volumes updated while maintaining full development speed. Monolithic Ruby gem structure: bin/ contains three entry points (docker-sync, docker-sync-daemon, docker-sync-stack), Gemfile/docker-sync.gemspec define dependencies, and docs/ (Sphinx-based) lives alongside the code. The tool likely uses a single lib/ directory (not shown in top 60)…

Start here

Open these first:

• lib/docker-sync.rb — Main entry point and library loader; every contributor must understand the module structure and initialization flow.
• lib/docker-sync/command.rb — CLI command dispatcher that routes user requests to sync managers; core interface between user and sync logic.
• lib/docker-sync/sync_manager.rb — Orchestrates sync operations and manages lifecycle; every contributor working on sync features must understand this.
• lib/docker-sync/config/project_config.rb — Parses and manages project-level docker-sync.yml configuration; essential for understanding how sync configurations are…
• lib/docker-sync/sync_strategy/native.rb — Reference implementation of a sync strategy (likely native Docker volumes); demonstrates how sync backends are plugged in.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/EugenMayer/docker-sync.git
cd docker-sync
bundle install
bin/docker-sync --help

For development: bundle exec bin/docker-sync to test CLI locally.

Daily commands:

Development mode: bundle exec bin/docker-sync start (after docker-sync.yml config). Run as daemon: bundle exec bin/docker-sync-daemon start. Stack integration: bundle exec bin/docker-sync-stack start. All commands…

…shortened for this brief.

Key cautions & unknowns

• Slowing — last commit 5mo ago
• Concentrated ownership — top contributor handles 58% of recent commits
• GPL-3.0 is copyleft — check downstream compatibility
• 1. docker-sync requires an active Docker daemon running; it will fail silently if Docker is not available or not mounted at /var/run/docker.sock. 2) Sync strategies (unison vs rsync vs native) require different native…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.