tlc-claude-code 0.9.3 → 0.9.5

package/.gitattributes

@@ -0,0 +1,2 @@
+# Force LF line endings for shell scripts
+*.sh text eol=lf

package/README.md

@@ -154,7 +154,7 @@ tlc init
 | URL | Service |
 |-----|---------|
 | http://localhost:3147 | Dashboard — Live preview, logs, tasks |
-| http://localhost:5000 | App — Your running application |
+| http://localhost:5001 | App — Your running application |
 | http://localhost:8080 | DB Admin — Database GUI (Adminer) |
 | localhost:5433 | Database — PostgreSQL |
 

package/bin/init.js

@@ -1,234 +1,234 @@
-#!/usr/bin/env node
-
-/**
- * TLC Init - Add TLC dev server launcher to a project
- * Usage: npx tlc-claude-code init
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const projectDir = process.cwd();
-
-// Windows batch file content
-const batContent = `@echo off
-:: ========================================
-:: TLC Dev Server Launcher
-:: ========================================
-:: Double-click to start your dev environment
-::
-:: Dashboard: http://localhost:3147
-:: App:       http://localhost:5000
-:: DB Admin:  http://localhost:8080
-:: Database:  localhost:5433
-:: ========================================
-
-setlocal
-
-:: Find TLC installation (check common locations)
-set TLC_DIR=
-if exist "C:\\Code\\TLC\\start-dev.ps1" set TLC_DIR=C:\\Code\\TLC
-if exist "%USERPROFILE%\\Code\\TLC\\start-dev.ps1" set TLC_DIR=%USERPROFILE%\\Code\\TLC
-if exist "%~dp0..\\TLC\\start-dev.ps1" set TLC_DIR=%~dp0..\\TLC
-
-:: Also check if installed globally via npm
-for /f "delims=" %%i in ('npm root -g 2^>nul') do (
-    if exist "%%i\\tlc-claude-code\\start-dev.ps1" set TLC_DIR=%%i\\tlc-claude-code
-)
-
-if "%TLC_DIR%"=="" (
-    echo [TLC] ERROR: Could not find TLC installation
-    echo [TLC] Install TLC or set TLC_DIR in this script
-    echo [TLC] See: https://github.com/jurgencalleja/TLC
-    pause
-    exit /b 1
-)
-
-:: Get project directory without trailing backslash
-set PROJECT_PATH=%~dp0
-if "%PROJECT_PATH:~-1%"=="\\" set PROJECT_PATH=%PROJECT_PATH:~0,-1%
-
-echo [TLC] Found TLC at: %TLC_DIR%
-echo [TLC] Starting dev server for: %PROJECT_PATH%
-echo.
-
-powershell -ExecutionPolicy Bypass -File "%TLC_DIR%\\start-dev.ps1" -ProjectPath "%PROJECT_PATH%"
-
-pause
-`;
-
-// macOS/Linux shell script
-const shContent = `#!/bin/bash
-# ========================================
-# TLC Dev Server Launcher
-# ========================================
-# Dashboard: http://localhost:3147
-# App:       http://localhost:5000
-# DB Admin:  http://localhost:8080
-# Database:  localhost:5433
-# ========================================
-
-set -e
-
-# Find TLC installation
-TLC_DIR=""
-LOCATIONS=(
-    "$HOME/.nvm/versions/node/*/lib/node_modules/tlc-claude-code"
-    "/usr/local/lib/node_modules/tlc-claude-code"
-    "/usr/lib/node_modules/tlc-claude-code"
-    "$HOME/.npm-global/lib/node_modules/tlc-claude-code"
-)
-
-# Check npm global
-NPM_ROOT=$(npm root -g 2>/dev/null || echo "")
-if [ -n "$NPM_ROOT" ] && [ -f "$NPM_ROOT/tlc-claude-code/start-dev.sh" ]; then
-    TLC_DIR="$NPM_ROOT/tlc-claude-code"
-fi
-
-# Check common locations
-if [ -z "$TLC_DIR" ]; then
-    for pattern in "\${LOCATIONS[@]}"; do
-        for dir in $pattern; do
-            if [ -f "$dir/start-dev.sh" ]; then
-                TLC_DIR="$dir"
-                break 2
-            fi
-        done
-    done
-fi
-
-if [ -z "$TLC_DIR" ]; then
-    echo "[TLC] ERROR: Could not find TLC installation"
-    echo "[TLC] Install with: npm install -g tlc-claude-code"
-    exit 1
-fi
-
-PROJECT_PATH="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
-
-echo "[TLC] Found TLC at: $TLC_DIR"
-echo "[TLC] Starting dev server for: $PROJECT_PATH"
-echo ""
-
-exec "$TLC_DIR/start-dev.sh" "$PROJECT_PATH"
-`;
-
-// Detect OS - WSL counts as Windows since user will double-click .bat from Explorer
-const isWSL = process.platform === 'linux' && fs.existsSync('/mnt/c');
-const isWindows = process.platform === 'win32' || isWSL;
-const launcherFile = isWindows ? 'tlc-start.bat' : 'tlc-start.sh';
-const launcherPath = path.join(projectDir, launcherFile);
-
-// FAST PATH: If launcher exists for this OS, just confirm and exit
-if (fs.existsSync(launcherPath)) {
-    console.log('');
-    console.log(`[TLC] Already initialized. ${launcherFile} exists.`);
-    console.log('');
-    if (isWindows) {
-        console.log('[TLC] To start: Double-click ' + launcherFile);
-    } else {
-        console.log('[TLC] To start: ./' + launcherFile);
-    }
-    console.log('[TLC] To rebuild: tlc rebuild');
-    console.log('');
-    process.exit(0);
-}
-
-console.log('');
-console.log('  ============================');
-console.log('       TLC Project Init');
-console.log('  ============================');
-console.log('');
-
-if (isWindows) {
-    // Create Windows launcher
-    const batPath = path.join(projectDir, 'tlc-start.bat');
-
-    if (fs.existsSync(batPath)) {
-        console.log('[TLC] tlc-start.bat already exists, overwriting...');
-    }
-    fs.writeFileSync(batPath, batContent);
-    console.log('[TLC] Created: tlc-start.bat');
-} else {
-    // Create Unix launcher (placeholder)
-    const shPath = path.join(projectDir, 'tlc-start.sh');
-
-    if (fs.existsSync(shPath)) {
-        console.log('[TLC] tlc-start.sh already exists, overwriting...');
-    }
-    fs.writeFileSync(shPath, shContent, { mode: 0o755 });
-    console.log('[TLC] Created: tlc-start.sh');
-    console.log('[TLC] Note: Full macOS/Linux support coming soon!');
-}
-
-// Add to .gitignore if not already there
-const gitignorePath = path.join(projectDir, '.gitignore');
-
-if (fs.existsSync(gitignorePath)) {
-    let gitignore = fs.readFileSync(gitignorePath, 'utf-8');
-    if (!gitignore.includes('tlc-start')) {
-        gitignore += '\\n# TLC dev server launcher (local only)\\ntlc-start.*\\n';
-        fs.writeFileSync(gitignorePath, gitignore);
-        console.log('[TLC] Added tlc-start.* to .gitignore');
-    }
-} else {
-    fs.writeFileSync(gitignorePath, '# TLC dev server launcher (local only)\\ntlc-start.*\\n');
-    console.log('[TLC] Created .gitignore with tlc-start.*');
-}
-
-// Create/update .tlc.json if it doesn't exist
-const tlcConfigPath = path.join(projectDir, '.tlc.json');
-if (!fs.existsSync(tlcConfigPath)) {
-    // Try to detect project settings
-    const pkgPath = path.join(projectDir, 'package.json');
-    let appPort = 3000;
-    let startCommand = 'npm run dev';
-
-    if (fs.existsSync(pkgPath)) {
-        try {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-            // Detect port from scripts if possible
-            if (pkg.scripts?.dev?.includes('--port')) {
-                const match = pkg.scripts.dev.match(/--port[=\\s]+(\\d+)/);
-                if (match) appPort = parseInt(match[1]);
-            }
-            if (pkg.scripts?.dev?.includes('5000')) appPort = 5000;
-            if (pkg.scripts?.dev?.includes('3000')) appPort = 3000;
-            if (pkg.scripts?.dev?.includes('5173')) appPort = 5173;
-        } catch (e) {
-            // Ignore parsing errors
-        }
-    }
-
-    const tlcConfig = {
-        server: {
-            startCommand: startCommand,
-            appPort: appPort
-        }
-    };
-
-    fs.writeFileSync(tlcConfigPath, JSON.stringify(tlcConfig, null, 2) + '\\n');
-    console.log('[TLC] Created: .tlc.json');
-}
-
-console.log('');
-console.log('[TLC] Setup complete!');
-console.log('');
-
-if (isWindows) {
-    console.log('[TLC] To start your dev server:');
-    console.log('      Double-click tlc-start.bat');
-    console.log('');
-    console.log('[TLC] Or run from command line:');
-    console.log('      .\\\\tlc-start.bat');
-} else {
-    console.log('[TLC] To start your dev server:');
-    console.log('      ./tlc-start.sh');
-}
-
-console.log('');
-console.log('[TLC] Services when running:');
-console.log('      Dashboard: http://localhost:3147');
-console.log('      App:       http://localhost:5000');
-console.log('      DB Admin:  http://localhost:8080');
-console.log('      Database:  localhost:5433');
-console.log('');
+#!/usr/bin/env node
+
+/**
+ * TLC Init - Add TLC dev server launcher to a project
+ * Usage: npx tlc-claude-code init
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const projectDir = process.cwd();
+
+// Windows batch file content
+const batContent = `@echo off
+:: ========================================
+:: TLC Dev Server Launcher
+:: ========================================
+:: Double-click to start your dev environment
+::
+:: Dashboard: http://localhost:3147
+:: App:       http://localhost:5001
+:: DB Admin:  http://localhost:8080
+:: Database:  localhost:5433
+:: ========================================
+
+setlocal
+
+:: Find TLC installation (check common locations)
+set TLC_DIR=
+if exist "C:\\Code\\TLC\\start-dev.ps1" set TLC_DIR=C:\\Code\\TLC
+if exist "%USERPROFILE%\\Code\\TLC\\start-dev.ps1" set TLC_DIR=%USERPROFILE%\\Code\\TLC
+if exist "%~dp0..\\TLC\\start-dev.ps1" set TLC_DIR=%~dp0..\\TLC
+
+:: Also check if installed globally via npm
+for /f "delims=" %%i in ('npm root -g 2^>nul') do (
+    if exist "%%i\\tlc-claude-code\\start-dev.ps1" set TLC_DIR=%%i\\tlc-claude-code
+)
+
+if "%TLC_DIR%"=="" (
+    echo [TLC] ERROR: Could not find TLC installation
+    echo [TLC] Install TLC or set TLC_DIR in this script
+    echo [TLC] See: https://github.com/jurgencalleja/TLC
+    pause
+    exit /b 1
+)
+
+:: Get project directory without trailing backslash
+set PROJECT_PATH=%~dp0
+if "%PROJECT_PATH:~-1%"=="\\" set PROJECT_PATH=%PROJECT_PATH:~0,-1%
+
+echo [TLC] Found TLC at: %TLC_DIR%
+echo [TLC] Starting dev server for: %PROJECT_PATH%
+echo.
+
+powershell -ExecutionPolicy Bypass -File "%TLC_DIR%\\start-dev.ps1" -ProjectPath "%PROJECT_PATH%"
+
+pause
+`;
+
+// macOS/Linux shell script
+const shContent = `#!/bin/bash
+# ========================================
+# TLC Dev Server Launcher
+# ========================================
+# Dashboard: http://localhost:3147
+# App:       http://localhost:5001
+# DB Admin:  http://localhost:8080
+# Database:  localhost:5433
+# ========================================
+
+set -e
+
+# Find TLC installation
+TLC_DIR=""
+LOCATIONS=(
+    "$HOME/.nvm/versions/node/*/lib/node_modules/tlc-claude-code"
+    "/usr/local/lib/node_modules/tlc-claude-code"
+    "/usr/lib/node_modules/tlc-claude-code"
+    "$HOME/.npm-global/lib/node_modules/tlc-claude-code"
+)
+
+# Check npm global
+NPM_ROOT=$(npm root -g 2>/dev/null || echo "")
+if [ -n "$NPM_ROOT" ] && [ -f "$NPM_ROOT/tlc-claude-code/start-dev.sh" ]; then
+    TLC_DIR="$NPM_ROOT/tlc-claude-code"
+fi
+
+# Check common locations
+if [ -z "$TLC_DIR" ]; then
+    for pattern in "\${LOCATIONS[@]}"; do
+        for dir in $pattern; do
+            if [ -f "$dir/start-dev.sh" ]; then
+                TLC_DIR="$dir"
+                break 2
+            fi
+        done
+    done
+fi
+
+if [ -z "$TLC_DIR" ]; then
+    echo "[TLC] ERROR: Could not find TLC installation"
+    echo "[TLC] Install with: npm install -g tlc-claude-code"
+    exit 1
+fi
+
+PROJECT_PATH="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+
+echo "[TLC] Found TLC at: $TLC_DIR"
+echo "[TLC] Starting dev server for: $PROJECT_PATH"
+echo ""
+
+exec "$TLC_DIR/start-dev.sh" "$PROJECT_PATH"
+`;
+
+// Detect OS - WSL counts as Windows since user will double-click .bat from Explorer
+const isWSL = process.platform === 'linux' && fs.existsSync('/mnt/c');
+const isWindows = process.platform === 'win32' || isWSL;
+const launcherFile = isWindows ? 'tlc-start.bat' : 'tlc-start.sh';
+const launcherPath = path.join(projectDir, launcherFile);
+
+// FAST PATH: If launcher exists for this OS, just confirm and exit
+if (fs.existsSync(launcherPath)) {
+    console.log('');
+    console.log(`[TLC] Already initialized. ${launcherFile} exists.`);
+    console.log('');
+    if (isWindows) {
+        console.log('[TLC] To start: Double-click ' + launcherFile);
+    } else {
+        console.log('[TLC] To start: ./' + launcherFile);
+    }
+    console.log('[TLC] To rebuild: tlc rebuild');
+    console.log('');
+    process.exit(0);
+}
+
+console.log('');
+console.log('  ============================');
+console.log('       TLC Project Init');
+console.log('  ============================');
+console.log('');
+
+if (isWindows) {
+    // Create Windows launcher
+    const batPath = path.join(projectDir, 'tlc-start.bat');
+
+    if (fs.existsSync(batPath)) {
+        console.log('[TLC] tlc-start.bat already exists, overwriting...');
+    }
+    fs.writeFileSync(batPath, batContent);
+    console.log('[TLC] Created: tlc-start.bat');
+} else {
+    // Create Unix launcher (placeholder)
+    const shPath = path.join(projectDir, 'tlc-start.sh');
+
+    if (fs.existsSync(shPath)) {
+        console.log('[TLC] tlc-start.sh already exists, overwriting...');
+    }
+    fs.writeFileSync(shPath, shContent, { mode: 0o755 });
+    console.log('[TLC] Created: tlc-start.sh');
+    console.log('[TLC] Note: Full macOS/Linux support coming soon!');
+}
+
+// Add to .gitignore if not already there
+const gitignorePath = path.join(projectDir, '.gitignore');
+
+if (fs.existsSync(gitignorePath)) {
+    let gitignore = fs.readFileSync(gitignorePath, 'utf-8');
+    if (!gitignore.includes('tlc-start')) {
+        gitignore += '\\n# TLC dev server launcher (local only)\\ntlc-start.*\\n';
+        fs.writeFileSync(gitignorePath, gitignore);
+        console.log('[TLC] Added tlc-start.* to .gitignore');
+    }
+} else {
+    fs.writeFileSync(gitignorePath, '# TLC dev server launcher (local only)\\ntlc-start.*\\n');
+    console.log('[TLC] Created .gitignore with tlc-start.*');
+}
+
+// Create/update .tlc.json if it doesn't exist
+const tlcConfigPath = path.join(projectDir, '.tlc.json');
+if (!fs.existsSync(tlcConfigPath)) {
+    // Try to detect project settings
+    const pkgPath = path.join(projectDir, 'package.json');
+    let appPort = 3000;
+    let startCommand = 'npm run dev';
+
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            // Detect port from scripts if possible
+            if (pkg.scripts?.dev?.includes('--port')) {
+                const match = pkg.scripts.dev.match(/--port[=\\s]+(\\d+)/);
+                if (match) appPort = parseInt(match[1]);
+            }
+            if (pkg.scripts?.dev?.includes('5001')) appPort = 5001;
+            if (pkg.scripts?.dev?.includes('3000')) appPort = 3000;
+            if (pkg.scripts?.dev?.includes('5173')) appPort = 5173;
+        } catch (e) {
+            // Ignore parsing errors
+        }
+    }
+
+    const tlcConfig = {
+        server: {
+            startCommand: startCommand,
+            appPort: appPort
+        }
+    };
+
+    fs.writeFileSync(tlcConfigPath, JSON.stringify(tlcConfig, null, 2) + '\\n');
+    console.log('[TLC] Created: .tlc.json');
+}
+
+console.log('');
+console.log('[TLC] Setup complete!');
+console.log('');
+
+if (isWindows) {
+    console.log('[TLC] To start your dev server:');
+    console.log('      Double-click tlc-start.bat');
+    console.log('');
+    console.log('[TLC] Or run from command line:');
+    console.log('      .\\\\tlc-start.bat');
+} else {
+    console.log('[TLC] To start your dev server:');
+    console.log('      ./tlc-start.sh');
+}
+
+console.log('');
+console.log('[TLC] Services when running:');
+console.log('      Dashboard: http://localhost:3147');
+console.log('      App:       http://localhost:5001');
+console.log('      DB Admin:  http://localhost:8080');
+console.log('      Database:  localhost:5433');
+console.log('');

package/docker-compose.dev.yml

@@ -36,9 +36,9 @@ services:
     environment:
       - NODE_ENV=development
       - DATABASE_URL=postgres://postgres:postgres@db:5432/app
-      - PORT=5000
+      - PORT=5001
     ports:
-      - "${APP_PORT:-5000}:5000"
+      - "${APP_PORT:-5001}:5001"
     volumes:
       - ${PROJECT_DIR:-.}:/app
       - /app/node_modules
@@ -69,7 +69,7 @@ services:
     environment:
       - TLC_PORT=3147
       - TLC_PROXY_ONLY=true
-      - TLC_APP_PORT=5000
+      - TLC_APP_PORT=5001
     ports:
       - "${DASHBOARD_PORT:-3147}:3147"
     volumes:
@@ -88,7 +88,7 @@ services:
       - test
     command: npx playwright test
     environment:
-      - BASE_URL=http://app:5000
+      - BASE_URL=http://app:5001
       - CI=true
     volumes:
       - ${PROJECT_DIR:-.}:/app

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tlc-claude-code",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
     "tlc": "./bin/tlc.js",
@@ -16,7 +16,8 @@
     "start-dev.sh",
     "start-dev.bat",
     "*.md",
-    "install.sh"
+    "install.sh",
+    ".gitattributes"
   ],
   "scripts": {
     "build": "cd dashboard && npm run build",

package/server/dashboard/index.html

@@ -589,9 +589,9 @@
       <div class="sidebar-section">
         <h3>Links</h3>
         <div class="links">
-          <a class="link" href="http://localhost:5000" target="_blank">
+          <a class="link" href="http://localhost:5001" target="_blank">
             <span>App</span>
-            <span class="url">:5000</span>
+            <span class="url">:5001</span>
           </a>
           <a class="link" href="http://localhost:8080" target="_blank">
             <span>Database Admin</span>

package/server.md

@@ -26,7 +26,7 @@ To start your dev environment:
 
 Services when running:
   Dashboard:  http://localhost:3147
-  App:        http://localhost:5000
+  App:        http://localhost:5001
   DB Admin:   http://localhost:8080
   Database:   localhost:5433
 

package/start-dev.ps1

@@ -81,7 +81,7 @@ Set-Location $scriptDir
 Write-Host ""
 Write-Host "[TLC] Starting services..." -ForegroundColor Yellow
 Write-Host "      Dashboard: http://localhost:3147" -ForegroundColor White
-Write-Host "      App:       http://localhost:5000" -ForegroundColor White
+Write-Host "      App:       http://localhost:5001" -ForegroundColor White
 Write-Host "      DB Admin:  http://localhost:8080" -ForegroundColor White
 Write-Host "      Database:  localhost:5433 (postgres/postgres)" -ForegroundColor Gray
 Write-Host ""

package/start-dev.sh

@@ -1,91 +1,91 @@
-#!/bin/bash
-
-# TLC Dev Server Launcher
-# Usage: ./start-dev.sh [project-path]
-
-set -e
-
-PROJECT_PATH="${1:-$(pwd)}"
-
-echo ""
-echo "  ============================"
-echo "       TLC Dev Server"
-echo "  ============================"
-echo ""
-
-# Check Docker
-echo "[TLC] Checking Docker..."
-if ! docker info >/dev/null 2>&1; then
-    echo "[TLC] Docker is not running."
-
-    # Try to start Docker based on OS
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        echo "[TLC] Starting Docker Desktop..."
-        open -a Docker
-    elif [[ -f /etc/debian_version ]] || [[ -f /etc/redhat-release ]]; then
-        echo "[TLC] Starting Docker service..."
-        sudo systemctl start docker 2>/dev/null || sudo service docker start 2>/dev/null || true
-    fi
-
-    echo "[TLC] Waiting for Docker..."
-    TIMEOUT=60
-    ELAPSED=0
-    while [ $ELAPSED -lt $TIMEOUT ]; do
-        sleep 2
-        ELAPSED=$((ELAPSED + 2))
-        if docker info >/dev/null 2>&1; then
-            break
-        fi
-        printf "."
-    done
-    echo ""
-
-    if ! docker info >/dev/null 2>&1; then
-        echo "[TLC] ERROR: Docker failed to start"
-        echo "[TLC] Please start Docker manually and try again"
-        exit 1
-    fi
-fi
-
-echo "[TLC] Docker is ready!"
-
-# Resolve project path
-PROJECT_PATH="$(cd "$PROJECT_PATH" 2>/dev/null && pwd)"
-if [ -z "$PROJECT_PATH" ]; then
-    echo "[TLC] ERROR: Invalid project path"
-    exit 1
-fi
-
-# Get project name from directory
-PROJECT_NAME=$(basename "$PROJECT_PATH" | tr '[:upper:]' '[:lower:]' | tr -cd 'a-z0-9')
-if [ -z "$PROJECT_NAME" ]; then
-    PROJECT_NAME="dev"
-fi
-
-echo "[TLC] Project: $PROJECT_PATH"
-echo "[TLC] Name:    $PROJECT_NAME"
-
-# Set environment
-export PROJECT_DIR="$PROJECT_PATH"
-export COMPOSE_PROJECT_NAME="$PROJECT_NAME"
-
-# Find TLC installation directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-
-echo ""
-echo "[TLC] Starting services..."
-echo "      Dashboard: http://localhost:3147"
-echo "      App:       http://localhost:5000"
-echo "      DB Admin:  http://localhost:8080"
-echo "      Database:  localhost:5433 (postgres/postgres)"
-echo ""
-echo "[TLC] Containers: tlc-$PROJECT_NAME-*"
-echo "[TLC] Press Ctrl+C to stop"
-echo ""
-
-# Run docker-compose
-docker-compose -f docker-compose.dev.yml up --build
-
-echo ""
-echo "[TLC] Stopped."
+#!/bin/bash
+
+# TLC Dev Server Launcher
+# Usage: ./start-dev.sh [project-path]
+
+set -e
+
+PROJECT_PATH="${1:-$(pwd)}"
+
+echo ""
+echo "  ============================"
+echo "       TLC Dev Server"
+echo "  ============================"
+echo ""
+
+# Check Docker
+echo "[TLC] Checking Docker..."
+if ! docker info >/dev/null 2>&1; then
+    echo "[TLC] Docker is not running."
+
+    # Try to start Docker based on OS
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "[TLC] Starting Docker Desktop..."
+        open -a Docker
+    elif [[ -f /etc/debian_version ]] || [[ -f /etc/redhat-release ]]; then
+        echo "[TLC] Starting Docker service..."
+        sudo systemctl start docker 2>/dev/null || sudo service docker start 2>/dev/null || true
+    fi
+
+    echo "[TLC] Waiting for Docker..."
+    TIMEOUT=60
+    ELAPSED=0
+    while [ $ELAPSED -lt $TIMEOUT ]; do
+        sleep 2
+        ELAPSED=$((ELAPSED + 2))
+        if docker info >/dev/null 2>&1; then
+            break
+        fi
+        printf "."
+    done
+    echo ""
+
+    if ! docker info >/dev/null 2>&1; then
+        echo "[TLC] ERROR: Docker failed to start"
+        echo "[TLC] Please start Docker manually and try again"
+        exit 1
+    fi
+fi
+
+echo "[TLC] Docker is ready!"
+
+# Resolve project path
+PROJECT_PATH="$(cd "$PROJECT_PATH" 2>/dev/null && pwd)"
+if [ -z "$PROJECT_PATH" ]; then
+    echo "[TLC] ERROR: Invalid project path"
+    exit 1
+fi
+
+# Get project name from directory
+PROJECT_NAME=$(basename "$PROJECT_PATH" | tr '[:upper:]' '[:lower:]' | tr -cd 'a-z0-9')
+if [ -z "$PROJECT_NAME" ]; then
+    PROJECT_NAME="dev"
+fi
+
+echo "[TLC] Project: $PROJECT_PATH"
+echo "[TLC] Name:    $PROJECT_NAME"
+
+# Set environment
+export PROJECT_DIR="$PROJECT_PATH"
+export COMPOSE_PROJECT_NAME="$PROJECT_NAME"
+
+# Find TLC installation directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo ""
+echo "[TLC] Starting services..."
+echo "      Dashboard: http://localhost:3147"
+echo "      App:       http://localhost:5001"
+echo "      DB Admin:  http://localhost:8080"
+echo "      Database:  localhost:5433 (postgres/postgres)"
+echo ""
+echo "[TLC] Containers: tlc-$PROJECT_NAME-*"
+echo "[TLC] Press Ctrl+C to stop"
+echo ""
+
+# Run docker-compose
+docker-compose -f docker-compose.dev.yml up --build
+
+echo ""
+echo "[TLC] Stopped."