tlc-claude-code 0.8.0 → 0.8.2

package/README.md

@@ -7,7 +7,7 @@
 **Test Led Coding for Claude Code. Tests before code. Automatically.**
 
 ```bash
-npx tlc-claude-code
+npx tlc-claude-code   # or just: tlc (after global install)
 ```
 
 <p align="center">
@@ -101,8 +101,7 @@ TLC knows where you are and what's next.
 | `/tlc:claim` | Reserve a task |
 | `/tlc:who` | See who's working on what |
 | `/tlc:bug` | Log a bug |
-| `/tlc:server` | Start dev server with dashboard |
-| `npx tlc-claude-code init` | Add Docker dev launcher to project |
+| `tlc init` | Add Docker dev launcher to project |
 
 ### Integration Commands
 
@@ -128,9 +127,10 @@ TLC supports distributed teams with git-based coordination.
 ```
 
 ```bash
-/tlc:claim 2        # Reserve task 2
-/tlc:who            # See team status
-/tlc:server         # Start dashboard for QA
+/tlc:claim 2                  # Reserve task 2
+/tlc:who                      # See team status
+tlc init      # Add dev server launcher
+# Then double-click tlc-start.bat
 ```
 
 **📄 [Full Team Workflow Guide →](docs/team-workflow.md)**
@@ -139,44 +139,34 @@ TLC supports distributed teams with git-based coordination.
 
 ## Dev Server
 
-Launch a mini-Replit for your team. Two options:
-
-### Option 1: Docker (Recommended)
-
-One-click launcher that runs your app, database, and dashboard in containers:
+Launch a mini-Replit for your team with Docker:
 
 ```bash
-# Add launcher to your project
-npx tlc-claude-code init
+# Add launcher to your project (one-time)
+tlc init
 
 # Then double-click tlc-start.bat (Windows)
 ```
 
 **What you get:**
-- **Dashboard**: http://localhost:3147 — Live preview, logs, tasks
-- **App**: http://localhost:5000 — Your running application
-- **Database**: localhost:5433 — PostgreSQL auto-provisioned
-
-Containers are named `tlc-{project}-*` so you can run multiple projects simultaneously.
-
-**Requirements:** [Docker Desktop](https://www.docker.com/products/docker-desktop)
 
-> **Note:** Windows only for now. macOS/Linux support coming soon.
-
-### Option 2: Direct (No Docker)
-
-```bash
-/tlc:server
-```
-
-Runs the app directly on your machine with auto-detected start command.
-
-### Features
+| URL | Service |
+|-----|---------|
+| http://localhost:3147 | Dashboard — Live preview, logs, tasks |
+| http://localhost:5000 | App — Your running application |
+| http://localhost:8080 | DB Admin — Database GUI (Adminer) |
+| localhost:5433 | Database — PostgreSQL |
 
+**Features:**
 - **Live preview** — Your app embedded in dashboard
 - **Real-time logs** — App, tests, git activity
 - **Bug submission** — Web form for QA
 - **Task board** — Who's working on what
+- **Multi-project** — Containers named `tlc-{project}-*` for simultaneous projects
+
+**Requirements:** [Docker Desktop](https://www.docker.com/products/docker-desktop)
+
+> **Note:** Windows only for now. macOS/Linux support coming soon.
 
 ---
 
@@ -271,14 +261,21 @@ C:\Code\TLC\                  (or your install location)
 ## Install
 
 ```bash
-# Interactive (choose global or local)
-npx tlc-claude-code
+# Install globally (recommended)
+npm install -g tlc-claude-code
+
+# Then use anywhere:
+tlc              # Install slash commands
+tlc init         # Add dev server to project
+tlc --help       # See all options
+```
 
-# Global (all projects)
-npx tlc-claude-code --global
+Or use without installing:
 
-# Local (this project only)
-npx tlc-claude-code --local
+```bash
+npx tlc-claude-code            # Interactive install
+npx tlc-claude-code --global   # Global install
+npx tlc-claude-code --local    # Local install only
 ```
 
 Commands install to `.claude/commands/tlc/`
@@ -289,7 +286,6 @@ Commands install to `.claude/commands/tlc/`
 
 - **[Help / All Commands](help.md)** — Complete command reference
 - **[Team Workflow](docs/team-workflow.md)** — Guide for teams (engineers + PO + QA)
-- **[Server Spec](server.md)** — Dev server documentation
 
 ---
 

package/bin/install.js

@@ -134,6 +134,12 @@ function install(targetDir, installType) {
 async function main() {
   const args = process.argv.slice(2);
 
+  // Handle 'init' subcommand - delegate to init.js
+  if (args[0] === 'init') {
+    require('./init.js');
+    return;
+  }
+
   printBanner();
 
   if (args.includes('--global') || args.includes('-g')) {

package/bin/tlc.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+/**
+ * TLC CLI - Simple entry point
+ *
+ * Usage:
+ *   tlc           - Install TLC commands (interactive)
+ *   tlc init      - Add dev server launcher to project
+ *   tlc server    - Start dev server
+ *   tlc setup     - Setup server requirements (Linux/macOS)
+ */
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+switch (command) {
+  case 'init':
+    require('./init.js');
+    break;
+  case 'server':
+    require('./server.js');
+    break;
+  case 'setup':
+    require('./setup.js');
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    console.log(`
+  TLC - Test Led Coding
+
+  Usage:
+    tlc              Install TLC commands to Claude Code
+    tlc init         Add dev server launcher (tlc-start.bat) to project
+    tlc server       Start the TLC dev server
+    tlc setup        Setup server requirements (Linux/macOS)
+
+  Options:
+    --global, -g     Install commands globally
+    --local, -l      Install commands locally
+
+  Examples:
+    tlc --global     Install commands for all projects
+    tlc init         Add Docker launcher to current project
+`);
+    break;
+  default:
+    // No subcommand = run install.js (the original behavior)
+    require('./install.js');
+}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "tlc-claude-code",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
+    "tlc": "./bin/tlc.js",
     "tlc-claude-code": "./bin/install.js",
     "tlc-dashboard": "./dashboard/dist/index.js",
     "tlc-server": "./bin/server.js",