Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Features

• scdev link command - create named link networks for direct container-to-container communication between separate projects

  • scdev link create <name> / scdev link delete <name> - manage named link networks
  • scdev link join <name> <member>... / scdev link leave <name> <member>... - add/remove projects or individual services
  • scdev link ls - list all links and their members
  • scdev link status <name> - show members and connection state
  • Members can be whole projects (sec-scan) or specific services (redis-debug.app)
  • Each link creates a dedicated Docker network (scdev_link_<name>) for isolation between link groups
  • Containers resolve each other by container name via Docker's embedded DNS (e.g., app.project-b.scdev)
  • Links persist in global state and auto-reconnect on scdev start
  • Validation: link name characters, project/service existence, duplicate prevention

• scdev info / scdev status / scdev list show link information - links are displayed alongside services and shared services

• scdev rename command - rename a project with full Docker resource migration

  • Stops containers, migrates volume data (named + Mutagen sync), removes old network
  • Updates state file and link memberships atomically
  • Rewrites name: in .scdev/config.yaml (preserves formatting and comments)
  • Restarts project with new name
  • Confirmation prompt (skip with --force)
  • Validates new name is DNS-safe and not already taken

Bug Fixes

• Fix variables in typed config fields - ${VAR} placeholders in int/bool fields (e.g., port: ${PORT}, router: ${ENABLE}) caused "cannot unmarshal !!str into int" errors. The first config parse pass now uses a minimal struct, deferring typed field parsing until after variable substitution.

Improvements

• Added ContainerNameFor() standalone helper for building container names without a loaded Project
• Added CopyVolume() to Runtime interface for volume data migration

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Features

• scdev link command - create named link networks for direct container-to-container communication between separate projects

  • scdev link create <name> / scdev link delete <name> - manage named link networks
  • scdev link join <name> <member>... / scdev link leave <name> <member>... - add/remove projects or individual services
  • scdev link ls - list all links and their members
  • scdev link status <name> - show members and connection state
  • Members can be whole projects (sec-scan) or specific services (redis-debug.app)
  • Each link creates a dedicated Docker network (scdev_link_<name>) for isolation between link groups
  • Containers resolve each other by container name via Docker's embedded DNS (e.g., app.project-b.scdev)
  • Links persist in global state and auto-reconnect on scdev start
  • Validation: link name characters, project/service existence, duplicate prevention

• scdev info / scdev status / scdev list show link information - links are displayed alongside services and shared services

• scdev rename command - rename a project with full Docker resource migration

  • Stops containers, migrates volume data (named + Mutagen sync), removes old network
  • Updates state file and link memberships atomically
  • Rewrites name: in .scdev/config.yaml (preserves formatting and comments)
  • Restarts project with new name
  • Confirmation prompt (skip with --force)
  • Validates new name is DNS-safe and not already taken

Bug Fixes

• Fix variables in typed config fields - ${VAR} placeholders in int/bool fields (e.g., port: ${PORT}, router: ${ENABLE}) caused "cannot unmarshal !!str into int" errors. The first config parse pass now uses a minimal struct, deferring typed field parsing until after variable substitution.

Improvements

• Added ContainerNameFor() standalone helper for building container names without a loaded Project
• Added CopyVolume() to Runtime interface for volume data migration

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Bug Fixes

• Fix shared service hostnames not resolving from project containers - docker network connect now passes --alias flags, so shared services (e.g., mail, adminer, redis-insights) are resolvable by their short names on project networks, not just on the shared network
• Fix Down() not releasing TCP/UDP host ports - Down() now refreshes the router to drop ports the project was using, preventing port conflicts on subsequent starts (previously only done in CLI commands, not the library method)

Improvements

• Integration tests restore shared services - tests that tear down shared services now snapshot what's running beforehand and restore it after, preventing silent breakage of the developer's running environment
• Updated docs (README, SKILL.md, templates/README.md) with shared service hostname reference - container-internal hostnames and ports for accessing services from app code vs browser

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Improvements

• Down() now handles state unregistration (previously only done in cmd/down.go), fixing stale entries left by integration tests
• Added integration tests for exec -- separator, config variables in running containers, per-service routing domain, and Down() state cleanup
• Added CONTRIBUTING.md with developer guide, architecture decisions, and test strategy

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Features

• scdev create command - scaffold new projects from templates (GitHub repos or local directories)
  • Template resolution: bare name (express), full repo (myorg/repo), or local path (./dir)
  • --branch and --tag flags for GitHub templates
  • --auto-start and --auto-setup flags for non-interactive setup
  • DNS-safe project name validation
  • GitHub tarball download with security hardening (symlink validation, size limits, mode masking, path traversal checks)
• Config variables - variables: section for reusable ${VAR} substitution across the config file (not passed to containers). Variables can reference built-in variables like ${PROJECTNAME}.
• Per-service routing domain - routing.domain allows individual HTTP/HTTPS services to have custom domains (e.g. api.my-app.scalecommerce.site for a backend service)
• scdev start -q/--quiet - skip project info display after start (useful in scripts and setup.just)
• Docker availability check - all Docker-dependent commands now check if Docker is running and show a clear error message instead of confusing Docker errors
• scdev exec handles -- separator - scdev exec app -- cmd now works correctly

Templates

• Three official templates published:
  • express - Node.js + Express hello world with --watch mode
  • nuxt4 - Nuxt 4 with interactive scaffolding, HMR, nuxi prepare for module deps
  • symfony - Symfony with CLI dev server, scaffold-in-/tmp pattern
• Template Authoring Guide at templates/README.md
• .setup-complete marker pattern for solving container startup vs setup circular dependency

Improvements

• shared.redis_insights renamed to shared.redis in project config (consistent with shared.router, shared.mail, shared.db)
• buildContainerConfig is now the single source of truth for container configuration (fixes divergence between start and update paths)
• connectRouter uses shared helper pattern (consistent with mail/db/redis)
• Extracted IsDBServiceByName() to eliminate duplicate DB detection logic
• Reduced redundant GlobalConfig loading in status command
• Removed dead sync_mode code from Mutagen sync
• Fixed unsafe append in cleanup command
• Supply chain security messaging in README

Documentation

• README: Templates section, multi-service routing, configuration reference tables, supply chain security callout
• Template Authoring Guide: setup lifecycle, scaffolding patterns (in-place vs /tmp), framework-specific notes
• CLAUDE.md: templates docs, Docker check, variables, routing.domain
• scdev skill restructured with progressive disclosure (222-line SKILL.md + references/)

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Features

• Sync-ready gate - containers wait for Mutagen sync automatically, no more while [ ! -f ... ] workarounds
• Default protocol - routing.protocol defaults to http when port is set
• Default domain - domain defaults to {name}.scalecommerce.site when not set
• scdev skill - installable agent skill (npx skills add scalecommerce-dev/scdev) with full CLI reference, config templates for Node/PHP/Python, debugging guides, and setup workflows

Documentation

• Complete README rewrite with architecture diagram, benchmark data, and coding agents section
• New tagline: "Ever seen a developer and an AI agent fall in love with a dev environment?"
• File sync benchmark: 5x faster cold start vs Docker bind mounts on macOS
• "Standing on the Shoulders of Giants" section crediting all underlying technologies
• TCP/UDP routing, volumes, and custom commands documented in detail
• .pnpm-store must be in Mutagen ignore for pnpm projects (prevents native binary corruption across image changes)

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Improvements

• Shared service registry pattern — adding a new shared service is now one entry instead of editing 6+ locations
• Split project.go god file (1400→868 lines) into shared_services.go and mutagen_sync.go
• Single source of truth for global config defaults (newDefaultGlobalConfig()) — fixes RedisInsights image missing bug
• Removed unused StartRouterWithPorts parameters and unnecessary ConnectToProject/DisconnectFromProject aliases
• Fixed scdev info not showing shared services section when only redis_insights is enabled
• Consistent display names across all shared service methods

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Improvements

• Auto-discover named volumes from service definitions — no more redundant top-level volumes: section in project config
• Streamlined CLAUDE.md and planning docs — removed stale TODOs, marked completed phases
• Removed TODO comments from code — all tracked as Completo tickets

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ScaleCommerce-DEV/scdev/main/install.sh | sh

Initial Release

First public release of scdev - local development environment framework.

• Single-command project startup with scdev start
• Config-driven multi-service containers via .scdev/config.yaml
• Variable substitution (${PROJECTNAME}, ${PROJECTDIR}, ${SCDEV_DOMAIN})
• Project isolation via Docker networks with inter-service DNS
• Named volumes with persistence across restarts
• Project state tracking with scdev list and scdev info
• Shared Traefik router with automatic HTTPS via mkcert
• Shared Mailpit email catcher
• Shared Adminer database UI
• Shared Redis Insights browser
• Custom project commands via justfiles (.scdev/commands/)
• Mutagen file sync for fast macOS development
• Docs page with dynamic project list at docs.shared.<domain>
• Self-update command (scdev update)
• Install script for macOS and Linux