tlc-claude-code 0.8.4 → 0.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +7 -0
  2. package/package.json +1 -1
  3. package/server.md +19 -90
package/README.md CHANGED
@@ -163,6 +163,12 @@ tlc init
163
163
  - **Bug submission** — Web form for QA
164
164
  - **Task board** — Who's working on what
165
165
  - **Multi-project** — Containers named `tlc-{project}-*` for simultaneous projects
166
+ - **Hot reload** — Code changes apply instantly (no restart needed)
167
+
168
+ **Rebuild when needed:**
169
+ ```bash
170
+ tlc rebuild # After package.json changes or to get a clean slate
171
+ ```
166
172
 
167
173
  **Requirements:** [Docker Desktop](https://www.docker.com/products/docker-desktop)
168
174
 
@@ -267,6 +273,7 @@ npm install -g tlc-claude-code
267
273
  # Then use anywhere:
268
274
  tlc # Install slash commands to Claude Code
269
275
  tlc init # Add Docker launcher to project (creates tlc-start.bat)
276
+ tlc rebuild # Full Docker rebuild (after package.json changes)
270
277
  tlc --help # See all options
271
278
  ```
272
279
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tlc-claude-code",
3
- "version": "0.8.4",
3
+ "version": "0.8.6",
4
4
  "description": "TLC - Test Led Coding for Claude Code",
5
5
  "bin": {
6
6
  "tlc": "./bin/tlc.js",
package/server.md CHANGED
@@ -1,110 +1,39 @@
1
1
  # /tlc:server - TLC Development Server
2
2
 
3
- Launch a unified development environment with live app preview, real-time logs, and team collaboration.
3
+ Set up Docker-based development environment.
4
4
 
5
5
  ## Instructions for Claude
6
6
 
7
- **DO NOT generate server code. Run the pre-built server from the TLC package.**
7
+ **IMPORTANT: Keep this simple. Do exactly these steps:**
8
8
 
9
- ### Step 1: Start Server
9
+ ### Step 1: Create the launcher
10
10
 
11
- Run this command in the user's project directory:
11
+ Run this command:
12
12
 
13
13
  ```bash
14
- npx -p tlc-claude-code tlc-server
14
+ npx tlc-claude-code init
15
15
  ```
16
16
 
17
- That's it. The server will:
18
- - Auto-detect the project type
19
- - Start the user's app
20
- - Open dashboard at http://localhost:3147
17
+ ### Step 2: Tell the user
21
18
 
22
- ### Step 2: Show User the URLs
19
+ Say exactly this:
23
20
 
24
21
  ```
25
- TLC Dev Server running!
22
+ Done! Created tlc-start.bat
26
23
 
27
- Dashboard: http://localhost:3147
28
- Share: http://{local-ip}:3147
24
+ To start your dev environment:
25
+ Double-click tlc-start.bat
29
26
 
30
- Open dashboard in browser to see:
31
- - Live app preview
32
- - Real-time logs (App / Tests / Git)
33
- - Task board
34
- - Bug submission form
35
- ```
36
-
37
- ---
38
-
39
- ## What the Server Does
40
-
41
- - **Auto-detects** project type (Node, Python, Go, Ruby, Rust)
42
- - **Starts your app** using detected dev command
43
- - **Proxies** app at `/app/` to avoid CORS
44
- - **Streams logs** via WebSocket
45
- - **Shows tasks** from `.planning/phases/*-PLAN.md`
46
- - **Accepts bugs** via web form → `.planning/BUGS.md`
47
-
48
- ## Configuration
49
-
50
- Override auto-detection in `.tlc.json`:
51
-
52
- ```json
53
- {
54
- "server": {
55
- "startCommand": "npm run dev",
56
- "appPort": 3000,
57
- "dashboardPort": 3147
58
- }
59
- }
60
- ```
61
-
62
- ## Supported Project Types
27
+ Services when running:
28
+ Dashboard: http://localhost:3147
29
+ App: http://localhost:5000
30
+ DB Admin: http://localhost:8080
31
+ Database: localhost:5433
63
32
 
64
- | File | Detected As | Command |
65
- |------|-------------|---------|
66
- | `package.json` (next) | Next.js | `npm run dev` |
67
- | `package.json` (vite) | Vite | `npm run dev` |
68
- | `package.json` (express) | Express | `npm start` |
69
- | `pyproject.toml` | FastAPI | `uvicorn main:app --reload` |
70
- | `requirements.txt` | Flask | `flask run` |
71
- | `go.mod` | Go | `go run .` |
72
- | `Gemfile` (rails) | Rails | `rails server` |
73
- | `Cargo.toml` | Rust | `cargo run` |
33
+ Requires: Docker Desktop
74
34
 
75
- ## Dashboard Features
76
-
77
- ```
78
- ┌─────────────────────────────────────────────────────────────────┐
79
- │ TLC Dev Server [Run Tests] [Restart] │
80
- ├─────────────────────────────────────────────────────────────────┤
81
- │ │ │
82
- │ ┌─────────────────┐ │ ┌────────────────────────────┐ │
83
- │ │ LIVE PREVIEW │ │ │ LOGS [App] [Tests] [Git] │ │
84
- │ │ (your app) │ │ │ > Server started :3000 │ │
85
- │ └─────────────────┘ │ │ > GET /api/users 200 12ms │ │
86
- │ │ └────────────────────────────┘ │
87
- │ ┌─────────────────┐ │ ┌────────────────────────────┐ │
88
- │ │ REPORT BUG │ │ │ TASKS (from PLAN.md) │ │
89
- │ │ [textarea] │ │ │ ✓ Task 1 @alice │ │
90
- │ │ [Submit] │ │ │ → Task 2 @bob │ │
91
- │ └─────────────────┘ │ │ ○ Task 3 (available) │ │
92
- │ │ └────────────────────────────┘ │
93
- └─────────────────────────────────────────────────────────────────┘
35
+ Commands:
36
+ tlc rebuild - Full rebuild after package.json changes
94
37
  ```
95
38
 
96
- ## QA Workflow
97
-
98
- 1. Engineer runs `/tlc:server`
99
- 2. QA opens `http://192.168.x.x:3147` in browser
100
- 3. QA tests app in live preview
101
- 4. QA submits bugs via web form
102
- 5. Bugs appear in `.planning/BUGS.md`
103
- 6. Engineer fixes, app hot-reloads
104
- 7. QA re-tests
105
-
106
- ## Notes
107
-
108
- - Works on local network (share IP with QA)
109
- - For remote: `ngrok http 3147`
110
- - All data flows through git
39
+ **That's it. Don't show alternatives or workarounds. Don't mention npm scripts.**