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.
- package/README.md +7 -0
- package/package.json +1 -1
- 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
package/server.md
CHANGED
|
@@ -1,110 +1,39 @@
|
|
|
1
1
|
# /tlc:server - TLC Development Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Set up Docker-based development environment.
|
|
4
4
|
|
|
5
5
|
## Instructions for Claude
|
|
6
6
|
|
|
7
|
-
**
|
|
7
|
+
**IMPORTANT: Keep this simple. Do exactly these steps:**
|
|
8
8
|
|
|
9
|
-
### Step 1:
|
|
9
|
+
### Step 1: Create the launcher
|
|
10
10
|
|
|
11
|
-
Run this command
|
|
11
|
+
Run this command:
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
|
-
npx
|
|
14
|
+
npx tlc-claude-code init
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
|
|
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
|
-
|
|
19
|
+
Say exactly this:
|
|
23
20
|
|
|
24
21
|
```
|
|
25
|
-
|
|
22
|
+
Done! Created tlc-start.bat
|
|
26
23
|
|
|
27
|
-
|
|
28
|
-
|
|
24
|
+
To start your dev environment:
|
|
25
|
+
Double-click tlc-start.bat
|
|
29
26
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.**
|