clitrigger 0.1.1 → 0.1.4

package/.env.example

@@ -1,7 +1,7 @@
 # production으로 설정 시 CORS_ORIGIN에 명시된 도메인만 허용 (미설정 시 모든 origin 허용)
 NODE_ENV=
 PORT=3000
-AUTH_PASSWORD=changeme
+AUTH_PASSWORD=changeme          # 필수 — 웹 UI 로그인 비밀번호
 SESSION_SECRET=
 CORS_ORIGIN=http://localhost:5173,http://localhost:3000
 TUNNEL_ENABLED=false

package/README.md

@@ -1,6 +1,10 @@
 <div align="center">
 
-# CLITrigger
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="src/client/public/logo.svg">
+  <source media="(prefers-color-scheme: light)" srcset="src/client/public/logo.svg">
+  <img alt="CLITrigger" src="src/client/public/logo.svg" width="360">
+</picture>
 
 **AI-Powered Parallel Worktree Automation**
 
@@ -25,6 +29,11 @@
 > 하지만 **이해 없는 바이브 코딩**은 결국 한계에 부딪힌다.  
 > CLITrigger는 AI를 병렬로 돌리면서도, 개발자가 맥락을 잃지 않도록 설계되었다.
 
+<div align="center">
+  <img src="docs/images/screenshot-tasks.png" alt="Tasks — 병렬 워크트리 실행" width="800">
+  <p><em>병렬 워크트리에서 AI CLI가 동시에 작업을 처리하는 모습</em></p>
+</div>
+
 ---
 
 ## 왜 CLITrigger인가?
@@ -67,9 +76,19 @@ TODO를 작성하면 각 작업마다 격리된 git worktree가 자동 생성된
 ### 다중 AI 토론 (Discussion)
 아키텍트, 개발자, 리뷰어 등 역할이 다른 AI 에이전트들이 라운드 방식으로 토론한 뒤, 합의된 내용을 바탕으로 자동 구현까지 이어진다. 단일 AI의 판단보다 훨씬 검증된 설계 결과물이 나온다.
 
+<div align="center">
+  <img src="docs/images/screenshot-discussions.png" alt="Discussions — 다중 AI 토론" width="800">
+  <p><em>여러 AI 에이전트가 역할별로 토론하는 Discussion 화면</em></p>
+</div>
+
 ### 예약 실행 (Scheduler)
 토큰 한도를 피해 새벽이나 특정 시각에 작업을 예약 실행할 수 있다. cron 기반 반복 스케줄과 일회성 예약 모두 지원한다.
 
+<div align="center">
+  <img src="docs/images/screenshot-schedules.png" alt="Schedules — 예약 실행" width="800">
+  <p><em>cron 기반 반복·일회성 예약 실행 설정 화면</em></p>
+</div>
+
 ### 파이프라인 (Pipeline)
 여러 작업을 순차 또는 병렬로 묶어 다단계 실행 흐름을 구성한다. 복잡한 릴리스 절차도 자동화할 수 있다.
 
@@ -118,6 +137,9 @@ clitrigger config password     # 비밀번호 변경
 ```
 
 > **사전 요구사항**: Node.js 20+, Git, 사용할 AI CLI (Claude / Gemini / Codex 중 하나 이상)
+>
+> **지원 플랫폼**: Windows · macOS · Linux — 모든 핵심 코드가 크로스 플랫폼 대응되어 있다.
+> macOS에서는 네이티브 모듈 빌드를 위해 `xcode-select --install`이 필요할 수 있다.
 
 ### 소스에서 직접 실행 (개발용)
 
@@ -154,6 +176,17 @@ npm run dev
 | `start-tunnel.bat` | 터널 모드 실행 |
 | `test.bat` | 전체 테스트 |
 
+#### macOS / Linux
+
+`npm run` 명령어가 모든 플랫폼에서 동일하게 동작한다. `.bat` 스크립트 대신 터미널에서 직접 실행하면 된다.
+
+```bash
+npm run dev        # 개발 모드
+npm run build      # 빌드
+npm run start      # 프로덕션 실행
+npm test           # 테스트
+```
+
 </details>
 
 ### 외부 접속 (Cloudflare Tunnel)

package/README_EN.md

@@ -0,0 +1,219 @@
+<div align="center">
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="src/client/public/logo.svg">
+  <source media="(prefers-color-scheme: light)" srcset="src/client/public/logo.svg">
+  <img alt="CLITrigger" src="src/client/public/logo.svg" width="360">
+</picture>
+
+**AI-Powered Parallel Worktree Automation**
+
+*Write tasks. Let AI execute them in parallel. Review and merge.*
+
+<p align="center">
+  <a href="README.md">한국어</a> ·
+  <a href="README_EN.md">English</a>
+</p>
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/clitrigger.svg)](https://www.npmjs.com/package/clitrigger)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org)
+[![React](https://img.shields.io/badge/React-18-61dafb.svg)](https://react.dev)
+
+</div>
+
+---
+
+> In the age of AI-generated code, the developer's role is shifting toward supervision and review.  
+> But **vibe coding without understanding** eventually hits a wall.  
+> CLITrigger lets you run AI in parallel — while keeping you in full context of what's happening.
+
+<div align="center">
+  <img src="docs/images/screenshot-tasks.png" alt="Tasks — Parallel worktree execution" width="800">
+  <p><em>AI CLIs working simultaneously across isolated git worktrees</em></p>
+</div>
+
+---
+
+## Why CLITrigger?
+
+Boris Cherny, creator of Claude Code, emphasizes **parallelism** as the key to AI-assisted development. Waiting for one task to finish before starting the next is the new bottleneck.
+
+At the same time, most AI services have **rate limits** — you can burn through your daily quota by noon and be stuck waiting until midnight.
+
+CLITrigger solves both problems:
+
+- **Right now** — Multiple tasks run in isolated git worktrees, with Claude / Gemini / Codex executing in parallel
+- **Without hitting limits** — Schedule tasks for off-peak hours to make the most of your token quota
+- **Better output** — Multiple AI agents debate and review before implementation, producing higher-quality results than a single AI working alone
+
+---
+
+## How It Works
+
+```
+[Write TODOs in the browser]
+         ↓
+┌──────────────────────────────────────────────────────────────┐
+│  TODO 1: Implement login      → worktree/feature-login     → Claude CLI → auto-commit  │
+│  TODO 2: Signup page          → worktree/feature-signup    → Gemini CLI → auto-commit  │
+│  TODO 3: Dashboard layout     → worktree/feature-dashboard → Claude CLI → auto-commit  │
+└──────────────────────────────────────────────────────────────┘
+         ↓
+[Live log streaming → Review diffs → Merge to main]
+```
+
+Each TODO runs in its **own isolated git worktree** — no conflicts, separate branches, independent commit history. You review the results and decide what to merge.
+
+---
+
+## Features
+
+### Parallel Worktree Execution
+Each TODO automatically gets its own git worktree. Claude / Gemini / Codex CLIs execute simultaneously in parallel. Dependency chains let you automatically trigger follow-up tasks and branch merges once prerequisites complete.
+
+### Multi-Agent Discussion
+AI agents with different roles — architect, developer, reviewer — debate in rounds before implementation. The resulting design is far more robust than a single AI working in isolation.
+
+<div align="center">
+  <img src="docs/images/screenshot-discussions.png" alt="Discussions — Multi-agent debate" width="800">
+  <p><em>Multiple AI agents with different roles debating in the Discussion view</em></p>
+</div>
+
+### Scheduled Execution
+Schedule tasks for off-peak hours to avoid rate limits. Supports both recurring cron schedules and one-time scheduled runs.
+
+<div align="center">
+  <img src="docs/images/screenshot-schedules.png" alt="Schedules — Scheduled execution" width="800">
+  <p><em>Cron-based recurring and one-time scheduled task execution</em></p>
+</div>
+
+### Pipeline Execution
+Chain tasks into multi-phase sequential or parallel pipelines. Automate complex release workflows end-to-end.
+
+### Live Logs & Built-in Git Client
+WebSocket-based real-time log streaming. Commit, push, merge, and manage branches directly from the web UI — so you always stay in context.
+
+### Multi-CLI & Sandbox Mode
+Select Claude / Gemini / Codex per project or per task. Strict sandbox mode restricts CLI file access to the worktree directory only.
+
+### Plugin System
+Jira, GitHub, Notion integrations and gstack skill injection — add external service integrations as self-contained plugins.
+
+### Remote Access
+Access and control from anywhere via Cloudflare Tunnel.
+
+---
+
+## Tech Stack
+
+| Layer | Tech |
+|-------|------|
+| Backend | Node.js · Express · TypeScript · SQLite · WebSocket |
+| Frontend | React 18 · Vite · Tailwind CSS |
+| AI CLIs | Claude · Gemini · Codex (Adapter Pattern) |
+| Git | simple-git (worktree management) |
+| Scheduling | node-cron |
+| Terminal | node-pty (TTY support) |
+| Remote Access | Cloudflare Tunnel (optional) |
+
+---
+
+## Quick Start
+
+```bash
+npm i -g clitrigger
+clitrigger
+```
+
+On first run, you'll be prompted to set a password. Then the server starts immediately.  
+Open `http://localhost:3000` → Register a project → Write TODOs → Click Start.
+
+```bash
+# Change settings
+clitrigger config port 8080    # Change port
+clitrigger config password     # Change password
+```
+
+> **Prerequisites**: Node.js 20+, Git, at least one AI CLI (Claude / Gemini / Codex)
+>
+> **Supported Platforms**: Windows · macOS · Linux — all core code is cross-platform compatible.
+> On macOS, you may need `xcode-select --install` for native module compilation.
+
+### Run from Source (for development)
+
+<details>
+<summary>Click to expand</summary>
+
+```bash
+# 1. Clone & install
+git clone https://github.com/OSgoodYZ/CLITrigger.git
+cd CLITrigger
+npm install
+cd src/client && npm install && cd ../..
+
+# 2. Configure environment
+cp .env.example .env
+# Edit .env and set AUTH_PASSWORD
+
+# 3. Run
+npm run dev
+```
+
+Open `http://localhost:5173`.
+
+#### Windows One-Click Scripts
+
+Double-click any bat file in `scripts/` — no terminal needed.
+
+| File | Action |
+|------|--------|
+| `install.bat` | Install dependencies (first time) |
+| `dev.bat` | Start development mode |
+| `build.bat` | Build project |
+| `start.bat` | Start production server |
+| `start-tunnel.bat` | Start with Cloudflare Tunnel |
+| `test.bat` | Run all tests |
+
+#### macOS / Linux
+
+`npm run` commands work identically on all platforms. Use the terminal instead of `.bat` scripts.
+
+```bash
+npm run dev        # Development mode
+npm run build      # Build
+npm run start      # Production server
+npm test           # Run tests
+```
+
+</details>
+
+### Remote Access (Cloudflare Tunnel)
+
+```bash
+# Install cloudflared
+winget install cloudflare.cloudflared    # Windows
+brew install cloudflared                  # macOS
+
+# Set TUNNEL_ENABLED=true in .env, then:
+npm run start:tunnel
+# → Outputs https://xxxx.trycloudflare.com in the console
+```
+
+---
+
+## Documentation
+
+| Doc | Content |
+|-----|---------|
+| [SETUP.md](docs/SETUP.md) | Detailed installation and usage guide |
+| [CHANGELOG.md](docs/CHANGELOG.md) | Version history |
+| [CICD.md](docs/CICD.md) | GitHub Actions CI/CD setup |
+| [TESTING.md](docs/TESTING.md) | Testing guide |
+
+---
+
+## License
+
+[MIT](LICENSE) — Free to use, modify, and distribute.

package/bin/clitrigger.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import { createInterface } from 'readline/promises';
+import { execSync, spawn } from 'child_process';
 
 const CONFIG_DIR = path.join(os.homedir(), '.clitrigger');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
@@ -15,7 +16,10 @@ if (args[0] === 'config') {
 } else if (args[0] === '--help' || args[0] === '-h') {
   printHelp();
 } else {
-  await startServer();
+  const updated = await checkAutoUpdate();
+  if (!updated) {
+    await startServer();
+  }
 }
 
 async function startServer() {
@@ -26,33 +30,73 @@ async function startServer() {
     console.log('Welcome to CLITrigger!\n');
     const rl = createInterface({ input: process.stdin, output: process.stdout });
 
-    const setPassword = await rl.question('비밀번호를 설정하시겠습니까? (y/N): ');
     let password = '';
-    if (setPassword.toLowerCase() === 'y') {
-      password = await rl.question('비밀번호: ');
+    while (!password) {
+      password = await rl.question('Set a password: ');
+      if (!password) console.log('Password is required.');
     }
     rl.close();
 
-    const config = { port: 3000, password };
+    const config = { port: 3000, password, tunnel: true };
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-    console.log(`\n✅ 설정 완료! (${CONFIG_FILE})`);
+    console.log(`\nSetup complete! (${CONFIG_FILE})`);
   }
 
   // config 읽고 env 설정
   const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+
+  // 기존 config에 비밀번호가 없으면 설정 강제
+  if (!config.password) {
+    console.log('Password is not set.\n');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    let password = '';
+    while (!password) {
+      password = await rl.question('Set a password: ');
+      if (!password) console.log('Password is required.');
+    }
+    rl.close();
+    config.password = password;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    console.log('Password saved.\n');
+  }
+
   process.env.PORT = String(config.port || 3000);
-  if (config.password) process.env.AUTH_PASSWORD = config.password;
+  process.env.AUTH_PASSWORD = config.password;
   process.env.DB_PATH = path.join(CONFIG_DIR, 'clitrigger.db');
+  // tunnel defaults to true (auto-enable for new and existing users)
+  if (config.tunnel !== false) {
+    process.env.TUNNEL_ENABLED = 'true';
+  }
+  if (config.tunnelName) {
+    process.env.TUNNEL_NAME = config.tunnelName;
+  }
 
   // 서버 시작
   await import('../dist/server/index.js');
 }
 
 async function handleConfig(args) {
+  if (args[0] === 'clear') {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      console.log('No config to delete.');
+      return;
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await rl.question(`All config and data in ${CONFIG_DIR} will be deleted. Continue? (y/N) `);
+    rl.close();
+    if (answer.toLowerCase() === 'y') {
+      fs.rmSync(CONFIG_DIR, { recursive: true, force: true });
+      console.log('Config and data deleted.');
+    } else {
+      console.log('Cancelled.');
+    }
+    return;
+  }
+
   fs.mkdirSync(CONFIG_DIR, { recursive: true });
 
   if (!fs.existsSync(CONFIG_FILE)) {
-    console.log('설정 파일이 없습니다. clitrigger를 먼저 실행해주세요.');
+    console.log('No config file found. Run clitrigger first.');
     process.exit(1);
   }
 
@@ -60,34 +104,120 @@ async function handleConfig(args) {
 
   if (args[0] === 'port') {
     if (!args[1]) {
-      console.log(`현재 포트: ${config.port || 3000}`);
+      console.log(`Current port: ${config.port || 3000}`);
       return;
     }
     const port = parseInt(args[1], 10);
     if (isNaN(port) || port < 1 || port > 65535) {
-      console.log('유효한 포트 번호를 입력해주세요. (1-65535)');
+      console.log('Please enter a valid port number. (1-65535)');
       process.exit(1);
     }
     config.port = port;
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-    console.log(`✅ 포트가 ${port}으로 변경되었습니다.`);
+    console.log(`Port changed to ${port}.`);
   } else if (args[0] === 'password') {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const password = await rl.question('새 비밀번호 (빈 값 = 비밀번호 해제): ');
+    let password = '';
+    while (!password) {
+      password = await rl.question('New password: ');
+      if (!password) console.log('Password is required.');
+    }
     rl.close();
     config.password = password;
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-    if (password) {
-      console.log('✅ 비밀번호가 변경되었습니다.');
-    } else {
-      console.log('✅ 비밀번호가 해제되었습니다.');
-    }
+    console.log('Password changed.');
   } else if (args[0] === 'path') {
     console.log(CONFIG_DIR);
+  } else if (args[0] === 'tunnel') {
+    if (!args[1]) {
+      console.log(`Tunnel: ${config.tunnel ? 'enabled' : 'disabled'}${config.tunnelName ? ` (name: ${config.tunnelName})` : ''}`);
+      return;
+    }
+    if (args[1] === 'on') {
+      config.tunnel = true;
+      if (args[2]) config.tunnelName = args[2];
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+      console.log(`Tunnel enabled.${config.tunnelName ? ` (name: ${config.tunnelName})` : ''}`);
+    } else if (args[1] === 'off') {
+      config.tunnel = false;
+      delete config.tunnelName;
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+      console.log('Tunnel disabled.');
+    } else {
+      console.log('Usage: clitrigger config tunnel [on [name] | off]');
+    }
   } else {
-    console.log(`현재 설정 (${CONFIG_FILE}):`);
-    console.log(`  포트: ${config.port || 3000}`);
-    console.log(`  비밀번호: ${config.password ? '설정됨' : '없음'}`);
+    console.log(`Config (${CONFIG_FILE}):`);
+    console.log(`  Port:     ${config.port || 3000}`);
+    console.log(`  Password: ${config.password ? 'set' : 'not set'}`);
+    console.log(`  Tunnel:   ${config.tunnel ? 'enabled' : 'disabled'}${config.tunnelName ? ` (name: ${config.tunnelName})` : ''}`);
+  }
+}
+
+function isNewerVersion(latest, current) {
+  const a = latest.split('.').map(Number);
+  const b = current.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((a[i] || 0) > (b[i] || 0)) return true;
+    if ((a[i] || 0) < (b[i] || 0)) return false;
+  }
+  return false;
+}
+
+async function checkAutoUpdate() {
+  // 업데이트 직후 재시작된 프로세스면 스킵
+  if (process.env.CLITRIGGER_UPDATED === '1') {
+    delete process.env.CLITRIGGER_UPDATED;
+    return false;
+  }
+
+  try {
+    if (!fs.existsSync(CONFIG_FILE)) return false;
+
+    const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+
+    // 24시간 이내에 체크했으면 스킵
+    const now = Date.now();
+    const lastCheck = config.lastUpdateCheck || 0;
+    if (now - lastCheck < 24 * 60 * 60 * 1000) return false;
+
+    // 체크 시간 저장 (네트워크 실패 시에도 반복 체크 방지)
+    config.lastUpdateCheck = now;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+
+    // 현재 버전 읽기
+    const pkgPath = new URL('../package.json', import.meta.url);
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    const currentVersion = pkg.version;
+
+    // npm registry에서 최신 버전 조회 (5초 타임아웃)
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const res = await fetch('https://registry.npmjs.org/clitrigger/latest', {
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+
+    if (!res.ok) return false;
+    const data = await res.json();
+    const latestVersion = data.version;
+
+    if (!isNewerVersion(latestVersion, currentVersion)) return false;
+
+    console.log(`\nUpdate available: v${currentVersion} -> v${latestVersion}, updating...`);
+    execSync('npm i -g clitrigger@latest', { stdio: 'inherit' });
+    console.log(`Updated to v${latestVersion}. Restarting...\n`);
+
+    // 업데이트된 코드로 재시작
+    const child = spawn(process.argv[0], process.argv.slice(1), {
+      stdio: 'inherit',
+      env: { ...process.env, CLITRIGGER_UPDATED: '1' },
+    });
+    child.on('exit', (code) => process.exit(code ?? 0));
+    return true;
+  } catch {
+    // 네트워크 오류, 타임아웃 등 — 무시하고 현재 버전으로 계속
+    return false;
   }
 }
 
@@ -96,11 +226,15 @@ function printHelp() {
 CLITrigger - AI-powered task execution tool
 
 Usage:
-  clitrigger                    서버 시작
-  clitrigger config             현재 설정 보기
-  clitrigger config port <n>    포트 변경
-  clitrigger config password    비밀번호 변경
-  clitrigger config path        설정 디렉토리 경로 출력
-  clitrigger --help             이 도움말 표시
+  clitrigger                          Start the server
+  clitrigger config                   Show current config
+  clitrigger config port <n>          Change port
+  clitrigger config password          Change password
+  clitrigger config tunnel on         Enable Cloudflare tunnel
+  clitrigger config tunnel on <name>  Enable named tunnel
+  clitrigger config tunnel off        Disable tunnel
+  clitrigger config path              Print config directory path
+  clitrigger config clear             Delete all config and data
+  clitrigger --help                   Show this help
 `.trim());
 }

package/bin/postuninstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.clitrigger');
+
+if (fs.existsSync(CONFIG_DIR)) {
+  console.log(`
+CLITrigger가 제거되었습니다.
+
+설정 및 데이터가 아래 경로에 남아 있습니다:
+  ${CONFIG_DIR}
+
+완전히 제거하려면 해당 폴더를 수동으로 삭제해주세요:
+  rm -rf ${CONFIG_DIR}
+`.trim());
+}