Yolo

Author: JonZeolla

{{cookiecutter.project_name|replace(" ", "")}}/.devcontainer/README.md

@@ -17,13 +17,19 @@ This project includes Dev Container support for VS Code and other compatible edi
 2. In VS Code, use Command Palette: `Dev Containers: Attach to Running Container`
 3. Select the `{{ cookiecutter.project_slug }}-dev` container
 
-### Option 3: Manual Docker Commands
+### Option 3: Command Line Access
 ```bash
 # Build and start the dev container
 task dev-container
 
+# Check if container is running
+task dev-container-status
+
 # Access the container shell
-docker exec -it {{ cookiecutter.project_slug }}-dev bash
+task dev-container-shell
+
+# Run a specific command
+task dev-container-exec CMD="python --version"
 
 # Stop the container when done
 task dev-container-stop
@@ -41,7 +47,7 @@ The dev container includes:
 ## Environment
 
 - `DEV_MODE=true` - Installs all development dependencies
-- `PYTHONPATH=/workspace/src` - Ensures proper module imports
+- Python path set to `/workspace/src` - Ensures proper module imports
 - Working directory: `/workspace`
 
 ## Troubleshooting

{{cookiecutter.project_name|replace(" ", "")}}/README.md

@@ -50,6 +50,50 @@ This project is configured with automated dependency management:
 
 Both tools are pre-configured and will start working once the repository is pushed to GitHub.
 
+## Development Containers
+
+This project includes Dev Container support for consistent development environments.
+
+### Quick Start with VS Code
+
+1. Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+2. Open this project in VS Code
+3. Click "Reopen in Container" when prompted, or use the command palette: `Dev Containers: Reopen in Container`
+
+### Alternative: Attach to Running Container
+
+If you prefer to manage the container manually:
+
+```bash
+# Build and start the development container
+task dev-container
+
+# Check container status
+task dev-container-status
+
+# Access the container shell
+task dev-container-shell
+
+# Run a specific command in the container
+task dev-container-exec CMD="python --version"
+
+# Stop the container when done
+task dev-container-stop
+```
+
+To attach from VS Code: Use command palette `Dev Containers: Attach to Running Container` and select `{{ cookiecutter.project_slug }}-dev`.
+
+### What's Included
+
+The development container provides:
+- Python {{ cookiecutter.python_version }}+ with all project dependencies
+- Development tools: uv, Task, pre-commit, git
+- VS Code extensions for Python development
+- Live code editing with proper volume mounts
+- All dependencies installed (including dev dependencies)
+
+For more details, see [.devcontainer/README.md](.devcontainer/README.md).
+
 ## FAQs
 
 For frequently asked questions including release workflow troubleshooting, see our [FAQ documentation](./FAQ.md).

{{cookiecutter.project_name|replace(" ", "")}}/Taskfile.yml

@@ -226,11 +226,11 @@ tasks:
       - |
         echo "✅ Development container '{{ '{{.PROJECT_SLUG}}' }}-dev' is running!"
         echo ""
-        echo "To attach to it:"
+        echo "To use it:"
         echo "  • VS Code: Use 'Dev Containers: Attach to Running Container' command"
-        echo "  • Terminal: docker exec -it {{ '{{.PROJECT_SLUG}}' }}-dev bash"
-        echo ""
-        echo "To stop it: task dev-container-stop"
+        echo "  • Terminal: task dev-container-shell"
+        echo "  • Check status: task dev-container-status"
+        echo "  • Stop: task dev-container-stop"
 
   dev-container-stop:
     desc: Stop and remove development container
@@ -239,6 +239,31 @@ tasks:
       - docker rm {{ '{{.PROJECT_SLUG}}' }}-dev 2>/dev/null || true
       - echo "Development container stopped and removed."
 
+  dev-container-exec:
+    desc: Execute a command in the development container (default: bash)
+    vars:
+      CMD: '{{ '{{.CMD | default "bash"}}' }}'
+    cmds:
+      - docker exec -it {{ '{{.PROJECT_SLUG}}' }}-dev {{ '{{.CMD}}' }}
+
+  dev-container-shell:
+    desc: Open a shell in the development container
+    cmds:
+      - task: dev-container-exec
+        vars:
+          CMD: bash
+
+  dev-container-status:
+    desc: Check status of the development container
+    cmds:
+      - |
+        if docker ps --format "table {{ '{{.Names}}' }}" | grep -q "^{{ '{{.PROJECT_SLUG}}' }}-dev$"; then
+          echo "✅ Development container '{{ '{{.PROJECT_SLUG}}' }}-dev' is running"
+        else
+          echo "❌ Development container '{{ '{{.PROJECT_SLUG}}' }}-dev' is not running"
+          echo "Run 'task dev-container' to start it"
+        fi
+
   clean:
     desc: Clean up build artifacts, cache files/directories, temp files, etc.
     cmds: