tacticremote 1.6.0 → 1.6.1

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 CHANGED
@@ -10,6 +10,14 @@ npx tacticremote
10
10
 
11
11
  That's it. Scan the QR code with the Tactic Remote iOS app to connect.
12
12
 
13
+ **Alternative install via Homebrew:**
14
+
15
+ ```bash
16
+ brew install TacticSpaceTech/tap/tacticremote
17
+ ```
18
+
19
+ [![Download on the App Store](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/app/tactic-remote/id6743597533)
20
+
13
21
  ## Prerequisites
14
22
 
15
23
  - **Node.js** 16+
@@ -0,0 +1,628 @@
1
+ #!/usr/bin/env node
2
+
3
+ 'use strict';
4
+
5
+ const os = require('os');
6
+ const path = require('path');
7
+ const crypto = require('crypto');
8
+ const readline = require('readline');
9
+ const { spawn, spawnSync } = require('child_process');
10
+
11
+ const VERSION = require('../package.json').version;
12
+ const QR_PROTOCOL_VERSION = '1.0'; // Fixed protocol version — iOS app validates this exactly
13
+
14
+ // ── ANSI (zero dependency) ──────────────────────────────────────────
15
+
16
+ const isTTY = process.stdout.isTTY;
17
+ const useColor = !process.env.NO_COLOR && isTTY;
18
+ const c = {
19
+ reset: useColor ? '\x1b[0m' : '',
20
+ bold: useColor ? '\x1b[1m' : '',
21
+ dim: useColor ? '\x1b[2m' : '',
22
+ green: useColor ? '\x1b[32m' : '',
23
+ red: useColor ? '\x1b[31m' : '',
24
+ yellow: useColor ? '\x1b[33m' : '',
25
+ cyan: useColor ? '\x1b[36m' : '',
26
+ magenta: useColor ? '\x1b[35m' : '',
27
+ gray: useColor ? '\x1b[90m' : '',
28
+ white: useColor ? '\x1b[37m' : '',
29
+ inverse: useColor ? '\x1b[7m' : '',
30
+ hide: useColor ? '\x1b[?25l' : '',
31
+ show: useColor ? '\x1b[?25h' : '',
32
+ up: useColor ? '\x1b[1A' : '',
33
+ erase: useColor ? '\x1b[2K' : '',
34
+ };
35
+
36
+ const ok = `${c.green}✔${c.reset}`;
37
+ const fail = `${c.red}✖${c.reset}`;
38
+ const warn = `${c.yellow}!${c.reset}`;
39
+ const dot = `${c.dim}·${c.reset}`;
40
+
41
+ // ── Brand ───────────────────────────────────────────────────────────
42
+
43
+ const LOGO = [
44
+ `${c.cyan} ╔╦╗${c.reset}${c.bold}╔═╗╔═╗╔╦╗╦╔═╗${c.reset} ${c.cyan}╦═╗╔═╗╔╦╗╔═╗╔╦╗╔═╗${c.reset}`,
45
+ `${c.cyan} ║ ${c.reset}${c.bold}╠═╣║ ║ ║║ ${c.reset} ${c.cyan}╠╦╝║╣ ║║║║ ║ ║ ║╣ ${c.reset}`,
46
+ `${c.cyan} ╩ ${c.reset}${c.bold}╩ ╩╚═╝ ╩ ╩╚═╝${c.reset} ${c.cyan}╩╚═╚═╝╩ ╩╚═╝ ╩ ╚═╝${c.reset}`,
47
+ ];
48
+
49
+ // ── Utilities ───────────────────────────────────────────────────────
50
+
51
+ const sleep = (ms) => new Promise(r => setTimeout(r, ms));
52
+
53
+ function which(cmd) {
54
+ const r = spawnSync('which', [cmd], { encoding: 'utf-8' });
55
+ return r.status === 0 ? r.stdout.trim() : null;
56
+ }
57
+
58
+ function getVersion(cmd, flag = '--version') {
59
+ try {
60
+ const r = spawnSync(cmd, [flag], { encoding: 'utf-8', timeout: 5000 });
61
+ if (r.status === 0) {
62
+ const m = (r.stdout + r.stderr).match(/(\d+\.\d+[\.\d]*)/);
63
+ return m ? m[1] : null;
64
+ }
65
+ } catch (_e) { /* ignore */ }
66
+ return null;
67
+ }
68
+
69
+ function getLocalIP() {
70
+ const interfaces = os.networkInterfaces();
71
+ for (const name of Object.keys(interfaces)) {
72
+ for (const iface of interfaces[name]) {
73
+ if (iface.family === 'IPv4' && !iface.internal) {
74
+ return iface.address;
75
+ }
76
+ }
77
+ }
78
+ return '127.0.0.1';
79
+ }
80
+
81
+ // ── Interactive menu ────────────────────────────────────────────────
82
+
83
+ function selectMenu(title, items) {
84
+ return new Promise((resolve) => {
85
+ if (!isTTY) {
86
+ resolve(items[0].value);
87
+ return;
88
+ }
89
+
90
+ let selected = 0;
91
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
92
+ readline.emitKeypressEvents(process.stdin, rl);
93
+ if (process.stdin.isTTY) process.stdin.setRawMode(true);
94
+
95
+ function render() {
96
+ // Move up and clear previous render
97
+ if (selected !== -1) {
98
+ for (let i = 0; i < items.length; i++) {
99
+ process.stdout.write(c.up + c.erase);
100
+ }
101
+ }
102
+ for (let i = 0; i < items.length; i++) {
103
+ const item = items[i];
104
+ const pointer = i === selected ? `${c.cyan}❯${c.reset}` : ' ';
105
+ const label = i === selected ? `${c.bold}${item.label}${c.reset}` : `${c.dim}${item.label}${c.reset}`;
106
+ const desc = item.desc ? ` ${c.dim}${item.desc}${c.reset}` : '';
107
+ console.log(` ${pointer} ${label}${desc}`);
108
+ }
109
+ }
110
+
111
+ console.log(` ${c.bold}${title}${c.reset} ${c.dim}(↑↓ to select, Enter to confirm)${c.reset}`);
112
+ console.log('');
113
+ // Initial placeholder lines
114
+ for (let i = 0; i < items.length; i++) {
115
+ console.log('');
116
+ }
117
+ render();
118
+
119
+ process.stdin.on('keypress', (_ch, key) => {
120
+ if (!key) return;
121
+ if (key.name === 'up' && selected > 0) {
122
+ selected--;
123
+ render();
124
+ } else if (key.name === 'down' && selected < items.length - 1) {
125
+ selected++;
126
+ render();
127
+ } else if (key.name === 'return') {
128
+ if (process.stdin.isTTY) process.stdin.setRawMode(false);
129
+ rl.close();
130
+ resolve(items[selected].value);
131
+ } else if (key.name === 'c' && key.ctrl) {
132
+ if (process.stdin.isTTY) process.stdin.setRawMode(false);
133
+ rl.close();
134
+ process.stdout.write(c.show);
135
+ console.log('');
136
+ process.exit(0);
137
+ }
138
+ });
139
+ });
140
+ }
141
+
142
+ function promptInput(question, defaultVal = '') {
143
+ return new Promise((resolve) => {
144
+ if (!isTTY) {
145
+ resolve(defaultVal);
146
+ return;
147
+ }
148
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
149
+ const prompt = defaultVal
150
+ ? ` ${question} ${c.dim}(${defaultVal})${c.reset}: `
151
+ : ` ${question}: `;
152
+ rl.question(prompt, (answer) => {
153
+ rl.close();
154
+ resolve(answer.trim() || defaultVal);
155
+ });
156
+ });
157
+ }
158
+
159
+ // ── Argument parsing (non-interactive fast path) ────────────────────
160
+
161
+ function parseArgs(argv) {
162
+ const args = argv.slice(2);
163
+ const opts = {
164
+ port: parseInt(process.env.PORT, 10) || 8765,
165
+ path: process.env.CLAUDE_REMOTE_ALLOWED_PATH || os.homedir(),
166
+ apiKey: process.env.CLAUDE_REMOTE_API_KEY || null,
167
+ bonjour: true,
168
+ qr: true,
169
+ tunnel: false,
170
+ hooks: null, // null = ask in interactive, true = install, false = skip
171
+ interactive: null, // null = auto (TTY → true)
172
+ };
173
+
174
+ for (let i = 0; i < args.length; i++) {
175
+ switch (args[i]) {
176
+ case '-v': case '--version':
177
+ console.log(VERSION);
178
+ process.exit(0);
179
+ break;
180
+ case '-h': case '--help':
181
+ printHelp();
182
+ process.exit(0);
183
+ break;
184
+ case '-p': case '--port':
185
+ opts.port = parseInt(args[++i], 10) || 8765;
186
+ break;
187
+ case '--path':
188
+ opts.path = path.resolve(args[++i] || os.homedir());
189
+ break;
190
+ case '--api-key':
191
+ opts.apiKey = args[++i];
192
+ break;
193
+ case '--tunnel':
194
+ opts.tunnel = true;
195
+ opts.interactive = false;
196
+ break;
197
+ case '--no-bonjour':
198
+ opts.bonjour = false;
199
+ break;
200
+ case '--no-qr':
201
+ opts.qr = false;
202
+ break;
203
+ case '--install-hooks':
204
+ opts.hooks = true;
205
+ break;
206
+ case '--no-hooks':
207
+ opts.hooks = false;
208
+ break;
209
+ case '--remove-hooks': {
210
+ const { removeHooks } = require('../lib/hookInstaller');
211
+ removeHooks();
212
+ console.log(` ${ok} Claude Code hooks removed`);
213
+ process.exit(0);
214
+ break;
215
+ }
216
+ case '--no-color':
217
+ break;
218
+ case '--no-interactive':
219
+ opts.interactive = false;
220
+ break;
221
+ }
222
+ }
223
+
224
+ if (opts.interactive === null) {
225
+ opts.interactive = isTTY;
226
+ }
227
+
228
+ return opts;
229
+ }
230
+
231
+ function printHelp() {
232
+ console.log('');
233
+ for (const line of LOGO) console.log(line);
234
+ console.log(`
235
+ ${c.dim}v${VERSION}${c.reset} Control Claude Code from your iPhone/iPad
236
+
237
+ ${c.bold}Usage${c.reset}
238
+ $ npx tacticremote ${c.dim}[options]${c.reset}
239
+
240
+ ${c.bold}Options${c.reset}
241
+ -p, --port <n> Port to listen on ${c.dim}[8765]${c.reset}
242
+ --path <dir> Allowed base directory ${c.dim}[$HOME]${c.reset}
243
+ --api-key <key> Require authentication
244
+ --tunnel Enable Cloudflare tunnel ${c.dim}(public access)${c.reset}
245
+ --install-hooks Install Claude Code hooks ${c.dim}(notifications)${c.reset}
246
+ --no-hooks Skip hook installation
247
+ --remove-hooks Remove installed hooks and exit
248
+ --no-bonjour Disable mDNS discovery
249
+ --no-qr Don't show QR code
250
+ --no-interactive Skip interactive prompts
251
+ --no-color Disable colored output
252
+ -v, --version Show version
253
+ -h, --help Show this help
254
+
255
+ ${c.bold}Examples${c.reset}
256
+ ${c.dim}$${c.reset} npx tacticremote
257
+ ${c.dim}$${c.reset} npx tacticremote --tunnel --api-key mysecret
258
+ ${c.dim}$${c.reset} npx tacticremote -p 9000
259
+
260
+ ${c.cyan}https://tacticremote.com${c.reset}
261
+ `);
262
+ }
263
+
264
+ // ── Preflight ───────────────────────────────────────────────────────
265
+
266
+ async function preflight(opts) {
267
+ console.log(` ${c.bold}Preflight${c.reset}`);
268
+ console.log('');
269
+
270
+ const checks = [];
271
+
272
+ // Node
273
+ const nodeVer = process.versions.node;
274
+ const nodeMajor = parseInt(nodeVer.split('.')[0], 10);
275
+ if (nodeMajor < 16) {
276
+ checks.push({ ok: false, msg: `Node.js v${nodeVer}`, hint: 'requires >= 16', fatal: true });
277
+ } else {
278
+ checks.push({ ok: true, msg: `Node.js ${c.dim}v${nodeVer}${c.reset}` });
279
+ }
280
+
281
+ // tmux
282
+ const tmuxPath = which('tmux');
283
+ if (!tmuxPath) {
284
+ const hint = process.platform === 'darwin' ? 'brew install tmux' : 'sudo apt install tmux';
285
+ checks.push({ ok: false, msg: 'tmux', hint, fatal: true });
286
+ } else {
287
+ const tmuxVer = getVersion('tmux', '-V');
288
+ checks.push({ ok: true, msg: `tmux ${c.dim}${tmuxVer || ''} (${tmuxPath})${c.reset}` });
289
+ }
290
+
291
+ // Claude
292
+ const claudePath = which('claude');
293
+ if (claudePath) {
294
+ checks.push({ ok: true, msg: `claude ${c.dim}(${claudePath})${c.reset}` });
295
+ } else {
296
+ checks.push({ ok: 'warn', msg: `claude ${c.dim}not in PATH (optional)${c.reset}` });
297
+ }
298
+
299
+ // cloudflared (if tunnel requested)
300
+ if (opts.tunnel) {
301
+ const cfPath = which('cloudflared');
302
+ if (!cfPath) {
303
+ const hint = process.platform === 'darwin'
304
+ ? 'brew install cloudflared'
305
+ : 'https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/';
306
+ checks.push({ ok: false, msg: 'cloudflared', hint, fatal: true });
307
+ } else {
308
+ checks.push({ ok: true, msg: `cloudflared ${c.dim}(${cfPath})${c.reset}` });
309
+ }
310
+ }
311
+
312
+ // Animate checks
313
+ for (const check of checks) {
314
+ if (isTTY) await sleep(120);
315
+ const icon = check.ok === true ? ok : check.ok === 'warn' ? warn : fail;
316
+ console.log(` ${icon} ${check.msg}`);
317
+ if (!check.ok && check.ok !== 'warn' && check.hint) {
318
+ console.log(` ${c.dim}${check.hint}${c.reset}`);
319
+ }
320
+ if (check.fatal && !check.ok) {
321
+ console.log('');
322
+ process.exit(1);
323
+ }
324
+ }
325
+
326
+ console.log('');
327
+ }
328
+
329
+ // ── Cloudflare Tunnel ───────────────────────────────────────────────
330
+
331
+ function startTunnel(port) {
332
+ return new Promise((resolve, reject) => {
333
+ const cfPath = which('cloudflared');
334
+ const proc = spawn(cfPath, ['tunnel', '--protocol', 'http2', '--url', `http://localhost:${port}`], {
335
+ stdio: ['ignore', 'pipe', 'pipe']
336
+ });
337
+
338
+ let resolved = false;
339
+ const urlPattern = /https:\/\/[a-zA-Z0-9-]+\.trycloudflare\.com/;
340
+ const timeout = setTimeout(() => {
341
+ if (!resolved) { resolved = true; reject(new Error('Tunnel timed out (30s)')); }
342
+ }, 30000);
343
+
344
+ const handleData = (data) => {
345
+ const match = data.toString().match(urlPattern);
346
+ if (match && !resolved) {
347
+ resolved = true;
348
+ clearTimeout(timeout);
349
+ resolve({ url: match[0], process: proc });
350
+ }
351
+ };
352
+
353
+ proc.stdout.on('data', handleData);
354
+ proc.stderr.on('data', handleData);
355
+ proc.on('error', (err) => { if (!resolved) { resolved = true; clearTimeout(timeout); reject(err); } });
356
+ proc.on('exit', (code) => { if (!resolved) { resolved = true; clearTimeout(timeout); reject(new Error(`cloudflared exited (${code})`)); } });
357
+ });
358
+ }
359
+
360
+ // ── Banner ──────────────────────────────────────────────────────────
361
+
362
+ function printBanner(opts, tunnelUrl) {
363
+ const ip = getLocalIP();
364
+ const line = `${c.dim}${'─'.repeat(42)}${c.reset}`;
365
+
366
+ console.log(line);
367
+ console.log('');
368
+
369
+ if (tunnelUrl) {
370
+ console.log(` ${c.cyan}PUBLIC${c.reset} ${c.bold}${tunnelUrl}${c.reset}`);
371
+ console.log(` ${c.dim}LAN ws://${ip}:${opts.port}${c.reset}`);
372
+ } else {
373
+ console.log(` ${c.dim}LAN${c.reset} ${c.cyan}ws://${ip}:${opts.port}${c.reset}`);
374
+ }
375
+ console.log(` ${c.dim}Hook${c.reset} http://${ip}:${opts.port}/hook`);
376
+ console.log(` ${c.dim}Auth${c.reset} ${opts.apiKey ? c.green + 'enabled' + c.reset : c.yellow + 'disabled' + c.reset}`);
377
+ console.log(` ${c.dim}Path${c.reset} ${opts.path}`);
378
+ console.log('');
379
+
380
+ if (opts.qr) {
381
+ try {
382
+ const qrcode = require('qrcode-terminal');
383
+ const qrData = tunnelUrl
384
+ ? JSON.stringify({ ip: '', port: 0, tunnelUrl, apiKey: opts.apiKey, mode: 'cloudflare', version: QR_PROTOCOL_VERSION })
385
+ : JSON.stringify({ ip, port: opts.port, apiKey: opts.apiKey || null, mode: 'lan', version: QR_PROTOCOL_VERSION });
386
+
387
+ qrcode.generate(qrData, { small: true }, (code) => {
388
+ const lines = code.split('\n');
389
+ for (const l of lines) {
390
+ if (l.trim()) console.log(` ${l}`);
391
+ }
392
+ console.log('');
393
+ console.log(` ${c.dim}Scan with Tactic Remote app${c.reset}`);
394
+ console.log(` ${c.dim}Get the app:${c.reset} ${c.cyan}https://apps.apple.com/app/tactic-remote/id6743597533${c.reset}`);
395
+ console.log(` ${c.cyan}https://tacticremote.com${c.reset}`);
396
+ console.log('');
397
+ console.log(line);
398
+ console.log(` ${c.dim}Ctrl+C to stop${c.reset}`);
399
+ console.log('');
400
+ });
401
+ } catch (_e) {
402
+ printFooter(line, tunnelUrl || `ws://${ip}:${opts.port}`);
403
+ }
404
+ } else {
405
+ printFooter(line, tunnelUrl || `ws://${ip}:${opts.port}`);
406
+ }
407
+ }
408
+
409
+ function printFooter(line, url) {
410
+ console.log(` ${c.dim}Connect:${c.reset} ${url}`);
411
+ console.log('');
412
+ console.log(line);
413
+ console.log(` ${c.dim}Ctrl+C to stop${c.reset}`);
414
+ console.log('');
415
+ }
416
+
417
+ // ── Main ────────────────────────────────────────────────────────────
418
+
419
+ async function main() {
420
+ const opts = parseArgs(process.argv);
421
+
422
+ // ── Logo ──
423
+ console.log('');
424
+ for (const line of LOGO) console.log(line);
425
+ console.log('');
426
+ console.log(` ${c.dim}v${VERSION} ${process.platform}/${os.arch()}${c.reset}`);
427
+ console.log('');
428
+
429
+ // ── Preflight (before interactive choices, so user sees deps) ──
430
+ await preflight(opts);
431
+
432
+ // ── Hooks ──
433
+ const { checkHooksInstalled, installHooks } = require('../lib/hookInstaller');
434
+ const hooksInstalled = checkHooksInstalled();
435
+
436
+ if (opts.hooks === true) {
437
+ // --install-hooks flag
438
+ if (!hooksInstalled) {
439
+ installHooks();
440
+ console.log(` ${ok} Claude Code hooks installed`);
441
+ console.log('');
442
+ } else {
443
+ console.log(` ${ok} Claude Code hooks already installed`);
444
+ console.log('');
445
+ }
446
+ } else if (opts.hooks === false) {
447
+ // --no-hooks flag — skip silently
448
+ } else if (hooksInstalled) {
449
+ console.log(` ${ok} Claude Code hooks installed`);
450
+ console.log('');
451
+ } else if (opts.interactive) {
452
+ // Ask user
453
+ const answer = await selectMenu('Install Claude Code hooks?', [
454
+ { label: 'Yes', desc: 'enable task completion & tool notifications', value: 'yes' },
455
+ { label: 'No', desc: 'skip (can install later with --install-hooks)', value: 'no' },
456
+ ]);
457
+ console.log('');
458
+ if (answer === 'yes') {
459
+ installHooks();
460
+ console.log(` ${ok} Claude Code hooks installed`);
461
+ console.log('');
462
+ }
463
+ } else {
464
+ console.log(` ${warn} Claude Code hooks not installed ${c.dim}(use --install-hooks)${c.reset}`);
465
+ console.log('');
466
+ }
467
+
468
+ // ── Interactive mode: choose connection ──
469
+ if (opts.interactive && !opts.tunnel) {
470
+ const mode = await selectMenu('Connection mode', [
471
+ { label: 'LAN', desc: 'local network (default)', value: 'lan' },
472
+ { label: 'Cloudflare Tunnel', desc: 'public access via wss://', value: 'tunnel' },
473
+ ]);
474
+
475
+ if (mode === 'tunnel') {
476
+ opts.tunnel = true;
477
+
478
+ // Check cloudflared
479
+ const cfPath = which('cloudflared');
480
+ if (!cfPath) {
481
+ console.log('');
482
+ console.log(` ${fail} cloudflared not found`);
483
+ const hint = process.platform === 'darwin' ? 'brew install cloudflared' : 'see cloudflare docs';
484
+ console.log(` ${c.dim}${hint}${c.reset}`);
485
+ console.log('');
486
+ process.exit(1);
487
+ }
488
+
489
+ // API key — required for tunnel, offer auto-generate
490
+ if (!opts.apiKey) {
491
+ console.log('');
492
+ const keyMode = await selectMenu('API Key (required for tunnel)', [
493
+ { label: 'Auto-generate', desc: 'random 32-char key', value: 'auto' },
494
+ { label: 'Enter manually', desc: 'type your own key', value: 'manual' },
495
+ ]);
496
+
497
+ if (keyMode === 'auto') {
498
+ opts.apiKey = crypto.randomBytes(16).toString('hex');
499
+ console.log('');
500
+ console.log(` ${ok} API Key: ${c.bold}${opts.apiKey}${c.reset}`);
501
+ console.log(` ${c.dim}Enter this key in the iOS app to connect${c.reset}`);
502
+ } else {
503
+ console.log('');
504
+ const key = await promptInput(`${c.bold}API key${c.reset}`);
505
+ if (!key) {
506
+ console.log(` ${fail} API key is required for tunnel mode`);
507
+ console.log('');
508
+ process.exit(1);
509
+ }
510
+ opts.apiKey = key;
511
+ }
512
+ }
513
+ }
514
+
515
+ // Ask port if user wants to change
516
+ console.log('');
517
+ const portAnswer = await promptInput(`${c.bold}Port${c.reset}`, String(opts.port));
518
+ const parsedPort = parseInt(portAnswer, 10);
519
+ if (parsedPort && parsedPort > 0 && parsedPort < 65536) {
520
+ opts.port = parsedPort;
521
+ }
522
+
523
+ console.log('');
524
+ }
525
+
526
+ // Non-interactive tunnel checks
527
+ if (opts.tunnel && !opts.apiKey) {
528
+ console.log(` ${fail} --api-key is required for --tunnel`);
529
+ console.log(` ${c.dim}npx tacticremote --tunnel --api-key mysecret${c.reset}`);
530
+ console.log('');
531
+ process.exit(1);
532
+ }
533
+
534
+ // ── Start server ──
535
+ console.log(` ${c.bold}Starting${c.reset}`);
536
+
537
+ const { ClaudeRemoteServer } = require('../server');
538
+ const server = new ClaudeRemoteServer({
539
+ port: opts.port,
540
+ allowedPath: opts.path,
541
+ apiKey: opts.apiKey,
542
+ });
543
+
544
+ let bonjour = null;
545
+ let tunnelProc = null;
546
+ let tunnelUrl = null;
547
+
548
+ try {
549
+ await server.start();
550
+ console.log(` ${ok} WebSocket server on 0.0.0.0:${opts.port}`);
551
+ } catch (err) {
552
+ if (err.code === 'EADDRINUSE') {
553
+ console.log(` ${fail} Port ${opts.port} is already in use`);
554
+ console.log(` ${c.dim}Try: --port ${opts.port + 1}${c.reset}`);
555
+ } else if (err.code === 'EACCES') {
556
+ console.log(` ${fail} Permission denied on port ${opts.port}`);
557
+ console.log(` ${c.dim}Use a port above 1024${c.reset}`);
558
+ } else {
559
+ console.log(` ${fail} ${err.message}`);
560
+ }
561
+ console.log('');
562
+ process.exit(1);
563
+ }
564
+
565
+ // Bonjour
566
+ if (opts.bonjour && !opts.tunnel) {
567
+ try {
568
+ const { BonjourPublisher } = require('../lib/bonjourPublisher');
569
+ bonjour = new BonjourPublisher(opts.port, !!opts.apiKey, { silent: true });
570
+ bonjour.start();
571
+ console.log(` ${ok} Bonjour mDNS`);
572
+ } catch (_e) {
573
+ console.log(` ${warn} Bonjour unavailable`);
574
+ }
575
+ }
576
+
577
+ // Cloudflare tunnel
578
+ if (opts.tunnel) {
579
+ console.log(` ${dot} Cloudflare tunnel ${c.dim}connecting...${c.reset}`);
580
+ try {
581
+ const result = await startTunnel(opts.port);
582
+ tunnelUrl = result.url;
583
+ tunnelProc = result.process;
584
+ process.stdout.write(c.up + c.erase);
585
+ console.log(` ${ok} Cloudflare tunnel ${c.dim}→${c.reset} ${c.cyan}${tunnelUrl}${c.reset}`);
586
+ } catch (err) {
587
+ process.stdout.write(c.up + c.erase);
588
+ console.log(` ${fail} Tunnel: ${err.message}`);
589
+ }
590
+ }
591
+
592
+ console.log('');
593
+
594
+ // ── Ready banner ──
595
+ printBanner(opts, tunnelUrl);
596
+
597
+ // ── Graceful shutdown ──
598
+ const shutdown = async (_signal) => {
599
+ console.log('');
600
+ console.log(` ${c.dim}Shutting down...${c.reset}`);
601
+
602
+ if (tunnelProc) {
603
+ tunnelProc.kill('SIGTERM');
604
+ console.log(` ${ok} Stopped tunnel`);
605
+ }
606
+
607
+ const killed = await server.stop();
608
+ if (killed.length > 0) {
609
+ console.log(` ${ok} Cleaned up ${killed.length} tmux session${killed.length > 1 ? 's' : ''}`);
610
+ }
611
+
612
+ if (bonjour) {
613
+ bonjour.stop();
614
+ }
615
+
616
+ console.log(` ${ok} Server closed`);
617
+ console.log('');
618
+ process.exit(0);
619
+ };
620
+
621
+ process.on('SIGINT', () => shutdown('SIGINT'));
622
+ process.on('SIGTERM', () => shutdown('SIGTERM'));
623
+ }
624
+
625
+ main().catch((err) => {
626
+ console.error(` ${fail} ${err.message}`);
627
+ process.exit(1);
628
+ });