dde

Orchestrates Docker-based development workflows via project-aware CLI commands.

47|9|Updated Jan 23, 2019
One-click install
npx skills add https://github.com/whatwedo/dde --skill dde
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dde
Source: https://github.com/whatwedo/dde/tree/main/skills/claude/dde
Command: npx skills add https://github.com/whatwedo/dde --skill dde

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing a local Docker development environment is error-prone when commands accidentally run on the host instead of the correct containers, and when project services, HTTPS, and database access need consistent lifecycle handling.

Core Features & Use Cases

  • Container-first project operations: Detects a .dde/ project and directs all project-dependent actions through dde project:* commands (for exec, lifecycle, logs, and status).
  • Reliable environment lifecycle management: Starts, stops, rebuilds, updates, and inspects both system services and per-project containers with options for hooks and forced rebuilds.
  • Database workflows and worktree isolation: Provides DB shells/export/import/snapshots and automatically rewrites database URLs for Git worktrees so each worktree gets its own hostname and TLS context.
  • Use Case: Start the correct project, run migrations, and debug a failing service while also handling HTTPS and local DNS so your app is reachable at the right .test URL.

Quick Start

Tell the AI to start your project environment by running dde project:up inside the directory that contains the .dde/ config.

Frequently Asked Questions about dde

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run local Docker development commands safely without hitting the host machine?

To run local Docker development commands safely, use a project-aware CLI that detects a `.dde/config.yml` file and routes all project-dependent actions through `dde project:exec` commands, preventing unsafe host execution. This ensures commands run inside the correct isolated containers.

What's the best way to manage Docker container lifecycle and status for a local project?

The best way to manage Docker container lifecycle is by using `dde project:*` commands to start, stop, rebuild, update, and inspect isolated project environments. This provides reliable lifecycle management for both system services and per-project containers with options for hooks and forced rebuilds.

How do I get separate database instances for Git worktrees in a Docker environment?

To get separate database instances for Git worktrees, the CLI automatically rewrites database URLs for each worktree, ensuring they receive unique hostnames and TLS contexts. This allows you to use DB shells, export/import, and snapshots safely within isolated worktree environments.

Does this Docker workflow tool support HTTPS and local DNS for `.test` URLs?

Yes, this Docker workflow tool supports HTTPS and local DNS configuration to make your application reachable at the correct `.test` URL. It handles local DNS and TLS context automatically when you start the project environment using `dde project:up`.

Can I get JSON output from Docker container logs and status commands?

Yes, you can get JSON output from Docker container logs and status commands. The CLI supports JSON output across its lifecycle, system, database, and project execution subcommands, allowing you to programmatically parse container states and log data.

Why are my project commands accidentally executing on the host instead of inside Docker containers?

Commands accidentally execute on the host when local development workflows lack project-aware orchestration. By requiring a `.dde/config.yml` file and directing actions through `dde project:exec`, the CLI ensures all project-dependent tasks are container-bound, preventing unsafe host execution.