triflux 0.0.1 → 2.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "triflux",
+  "description": "CLI-first multi-model orchestrator — Codex/Gemini/Claude routing with DAG execution, auto-triage, and cost optimization",
+  "owner": {
+    "name": "tellang"
+  },
+  "plugins": [
+    {
+      "name": "triflux",
+      "description": "CLI-first multi-model orchestrator for Claude Code. Routes tasks to Codex, Gemini, and Claude CLIs with automatic triage (Sonnet classification + Opus decomposition), DAG-based parallel execution, and cost-optimized routing. Includes 16 skills, HUD status bar, and shell-based CLI routing wrapper.",
+      "version": "1.0.0",
+      "author": {
+        "name": "tellang"
+      },
+      "source": "./",
+      "category": "productivity",
+      "homepage": "https://github.com/tellang/triflux",
+      "tags": [
+        "multi-model",
+        "codex",
+        "gemini",
+        "cli-routing",
+        "orchestration",
+        "cost-optimization",
+        "dag-execution"
+      ]
+    }
+  ],
+  "version": "1.0.0"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "triflux",
+  "version": "1.0.0",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "author": {
+    "name": "tellang"
+  },
+  "repository": "https://github.com/tellang/triflux",
+  "homepage": "https://github.com/tellang/triflux",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "mcpServers": {}
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tellang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,276 @@
+[English](README.md) | [한국어](README.ko.md)
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
+    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
+  </picture>
+</p>
+
+<p align="center">
+  <strong>CLI 기반 멀티모델 오케스트레이터</strong><br>
+  <em>Codex, Gemini, Claude에 작업을 라우팅 — 무료 티어로 할 수 있는 일에 토큰을 낭비하지 마세요</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
+  <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
+  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-374151?style=flat-square" alt="Node.js >= 18"></a>
+</p>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
+    <img alt="triflux 데모" src="docs/assets/demo-dark.gif" width="680">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="#빠른-시작">빠른 시작</a> ·
+  <a href="#스킬">스킬</a> ·
+  <a href="#아키텍처">아키텍처</a> ·
+  <a href="#설정-가이드">설정 가이드</a>
+</p>
+
+---
+
+## 왜 triflux인가?
+
+- **비용 지능형 라우팅** — Codex(무료)와 Gemini(무료)에 먼저 작업을 보내고, Claude 토큰은 최소화
+- **DAG 기반 병렬 실행** — 복잡한 작업을 의존 그래프로 분해하여 동시 실행
+- **자동 트리아지** — Codex가 분류 + Opus가 분해, 수동 에이전트 선택 불필요
+- **16가지 에이전트** — executor부터 architect까지, 각각 최적의 CLI와 effort 레벨에 매핑
+- **HUD 상태 표시줄** — CLI 상태, 토큰 절약량, 속도 제한 실시간 모니터링
+- **제로 설정** — 설치 후 Claude Code에서 바로 슬래시 명령어 사용
+
+<details>
+<summary><strong>설치</strong></summary>
+
+### 플러그인 (권장)
+
+```bash
+/plugin marketplace add https://github.com/tellang/triflux
+/plugin install triflux
+```
+
+### npm (전역)
+
+```bash
+npm install -g triflux
+```
+
+### npx (일회성)
+
+```bash
+npx triflux doctor
+```
+
+### 설치 확인
+
+```bash
+tfx doctor
+```
+
+</details>
+
+## 빠른 시작
+
+```bash
+# 자동 모드 — AI가 분류 + 분해 + 병렬 실행
+/tfx-auto "인증 모듈 리팩터링 + 로그인 UI 개선 + 테스트 추가"
+
+# 수동 모드 — 에이전트 수와 타입 직접 지정
+/tfx-auto 3:codex "src/api, src/auth, src/payment 각각 리뷰"
+
+# 커맨드 숏컷 — 단일 에이전트 즉시 실행
+/implement "JWT 인증 미들웨어 추가"
+/analyze "결제 모듈 보안 리뷰"
+/research "최신 React Server Components 패턴"
+
+# 단일 CLI 모드
+/tfx-codex "리팩터링 + 리뷰"    # Codex만 사용
+/tfx-gemini "구현 + 문서화"      # Gemini만 사용
+```
+
+## 스킬
+
+| 스킬 | 모드 | 설명 |
+|------|------|------|
+| `/tfx-auto` | 자동 | 트리아지 → 분해 → DAG 병렬 실행 |
+| `/tfx-codex` | Codex 전용 | 모든 CLI 작업을 Codex로 라우팅 |
+| `/tfx-gemini` | Gemini 전용 | 모든 CLI 작업을 Gemini로 라우팅 |
+| `/tfx-setup` | 설정 | 파일 동기화, HUD 설정, CLI 진단 |
+
+### 커맨드 숏컷
+
+트리아지 없이 즉시 단일 에이전트 실행:
+
+| 커맨드 | 에이전트 | CLI | 용도 |
+|--------|---------|-----|------|
+| `/implement` | executor | Codex | 코드 구현 |
+| `/build` | build-fixer | Codex | 빌드/타입 에러 수정 |
+| `/research` | document-specialist | Codex | 문서 조사 |
+| `/brainstorm` | analyst | Codex | 요구사항 분석 |
+| `/design` | architect | Codex | 아키텍처 설계 |
+| `/troubleshoot` | debugger | Codex | 버그 분석 |
+| `/cleanup` | executor | Codex | 코드 정리 |
+| `/analyze` | quality + security | Codex | 병렬 리뷰 (2 에이전트) |
+| `/spec-panel` | architect + analyst + critic | Codex | 스펙 리뷰 (3 에이전트) |
+| `/explain` | writer | Gemini | 코드 설명 |
+| `/document` | writer | Gemini | 문서 작성 |
+| `/test` | test-engineer | Claude | 테스트 전략 |
+| `/reflect` | verifier | Claude | 검증 |
+
+## 아키텍처
+
+```
+사용자: "/tfx-auto 인증 리팩터링 + UI 개선 + 테스트 추가"
+         |
+         v
+   [Phase 1: 파싱] ─── 자동 모드 감지
+         |
+         v
+   [Phase 2a: 분류] ─── Codex (무료)
+   │  인증 리팩터링 → codex
+   │  UI 개선       → gemini
+   │  테스트 추가   → claude
+         |
+         v
+   [Phase 2b: 분해] ─── Opus (인라인, Agent 스폰 없음)
+   │  t1: executor (implement, src/auth/)     Level 0
+   │  t2: designer (docs, src/components/)    Level 0
+   │  t3: test-engineer (Claude 네이티브)     Level 1 ← t1 의존
+         |
+         v
+   [Phase 3: 실행] ─── DAG 병렬
+   │  Level 0: t1(Codex) + t2(Gemini)  ← 병렬
+   │  Level 1: t3(Claude)               ← t1 완료 후
+         |
+         v
+   [Phase 4-6: 수집 → 재시도 → 보고]
+```
+
+### 에이전트 라우팅 테이블
+
+| 에이전트 | CLI | Effort | 타임아웃 | 모드 |
+|---------|-----|--------|---------|------|
+| executor | Codex | high | 360s | fg |
+| build-fixer | Codex | fast | 180s | fg |
+| debugger | Codex | high | 300s | bg |
+| deep-executor | Codex | xhigh | 1200s | bg |
+| architect | Codex | xhigh | 1200s | bg |
+| planner | Codex | xhigh | 1200s | fg |
+| critic | Codex | xhigh | 1200s | bg |
+| analyst | Codex | xhigh | 1200s | fg |
+| code-reviewer | Codex | thorough | 600s | bg |
+| security-reviewer | Codex | thorough | 600s | bg |
+| quality-reviewer | Codex | thorough | 600s | bg |
+| scientist | Codex | high | 480s | bg |
+| document-specialist | Codex | high | 480s | bg |
+| designer | Gemini Pro 3.1 | — | 600s | bg |
+| writer | Gemini Flash 3 | — | 600s | bg |
+| explore | Claude Haiku | — | 300s | fg |
+| verifier | Claude Sonnet | — | 300s | fg |
+| test-engineer | Claude Sonnet | — | 300s | bg |
+
+### 실패 처리
+
+1. **1차 실패** → Claude 네이티브 에이전트로 fallback
+2. **2차 실패** → 해당 서브태스크 실패 보고, 나머지 결과 종합
+3. **타임아웃** → 부분 결과 보고
+
+<details>
+<summary><strong>설정 가이드</strong></summary>
+
+### 사전 조건
+
+- **Node.js** >= 18
+- **Claude Code** (필수)
+- **Codex CLI** (선택): `npm install -g @openai/codex`
+- **Gemini CLI** (선택): `npm install -g @google/gemini-cli`
+
+> Codex/Gemini 없이도 동작합니다. 자동으로 Claude 네이티브 에이전트로 fallback됩니다.
+
+### 설치 후
+
+```bash
+# 파일 동기화 + HUD 설정
+tfx setup
+
+# 진단 실행
+tfx doctor
+```
+
+### CLI 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `tfx setup` | 스크립트 + HUD + 스킬 동기화 |
+| `tfx doctor` | CLI 진단 + 이슈 추적 |
+| `tfx update` | 최신 버전으로 업데이트 |
+| `tfx list` | 설치된 스킬 목록 |
+| `tfx version` | 버전 표시 |
+
+축약: `tfx` = `triflux`, `tfl` = `triflux`
+
+### HUD 상태 표시줄
+
+Claude Code 상태줄에서 실시간 모니터링:
+
+- Claude / Codex / Gemini 토큰 사용량 및 속도 제한
+- CLI 상태 (설치 여부, API 키 상태)
+- 세션 비용 추적 및 절약 보고서
+
+`tfx setup`으로 자동 설정됩니다.
+
+</details>
+
+<details>
+<summary><strong>oh-my-claudecode 통합</strong></summary>
+
+triflux는 단독으로 동작하거나 [oh-my-claudecode](https://github.com/nicepkg/oh-my-claudecode)와 함께 사용할 수 있습니다:
+
+- OMC 플러그인 시스템을 통한 스킬 자동 등록
+- `cli-route.sh`가 OMC 에이전트 카탈로그와 통합
+- HUD가 OMC 상태줄을 확장
+- OMC autopilot, ralph, team, ultrawork 모드와 호환
+
+</details>
+
+<details>
+<summary><strong>변경 이력</strong></summary>
+
+### 2.0.0
+
+- `cx-skills`에서 `triflux`로 리브랜딩
+- 새 CLI 명령어: `tfx`, `triflux`, `tfl`
+- 스킬 업데이트: `/tfx-auto`, `/tfx-codex`, `/tfx-gemini`, `/tfx-setup`
+- amber 브랜딩 시각적 리뉴얼
+- 내부 참조 전면 업데이트 (`CX_CLI_MODE` → `TFX_CLI_MODE`)
+
+### 이전 버전 (cx-skills)
+
+v1.x 이력은 [cx-skills releases](https://github.com/tellang/cx-skills/releases) 참조.
+
+</details>
+
+---
+
+<p align="center">
+  <a href="https://github.com/tellang/triflux">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tellang/triflux&type=Date&theme=dark">
+      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tellang/triflux&type=Date">
+      <img alt="Star History" src="https://api.star-history.com/svg?repos=tellang/triflux&type=Date" width="600">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <sub>MIT License · Made by <a href="https://github.com/tellang">tellang</a></sub>
+</p>

package/README.md

@@ -1 +1,276 @@
-# triflux\n\nCLI-first multi-model orchestrator for Claude Code.\n\nComing soon.
+[English](README.md) | [한국어](README.ko.md)
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
+    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
+  </picture>
+</p>
+
+<p align="center">
+  <strong>CLI-first multi-model orchestrator</strong><br>
+  <em>Route tasks to Codex, Gemini, and Claude — don't pay tokens for what free tiers can do</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
+  <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
+  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-374151?style=flat-square" alt="Node.js >= 18"></a>
+</p>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
+    <img alt="triflux demo" src="docs/assets/demo-dark.gif" width="680">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="#skills">Skills</a> ·
+  <a href="#architecture">Architecture</a> ·
+  <a href="#setup-guide">Setup Guide</a>
+</p>
+
+---
+
+## Why triflux?
+
+- **Cost-intelligent routing** — Automatically routes tasks to Codex (free) and Gemini (free) before spending Claude tokens
+- **DAG-based parallel execution** — Decomposes complex tasks into dependency graphs and runs them concurrently
+- **Auto-triage** — Codex classifies + Opus decomposes, no manual agent selection needed
+- **16 agent types** — From executor to architect, each mapped to the optimal CLI and effort level
+- **HUD status bar** — Real-time CLI health, token savings, and rate limit monitoring
+- **Zero config** — Install and start using slash commands in Claude Code immediately
+
+<details>
+<summary><strong>Install</strong></summary>
+
+### Plugin (recommended)
+
+```bash
+/plugin marketplace add https://github.com/tellang/triflux
+/plugin install triflux
+```
+
+### npm (global)
+
+```bash
+npm install -g triflux
+```
+
+### npx (one-off)
+
+```bash
+npx triflux doctor
+```
+
+### Verify
+
+```bash
+tfx doctor
+```
+
+</details>
+
+## Quick Start
+
+```bash
+# Auto mode — AI classifies + decomposes + executes in parallel
+/tfx-auto "refactor auth module + improve login UI + add tests"
+
+# Manual mode — specify agent count and type
+/tfx-auto 3:codex "review src/api, src/auth, src/payment"
+
+# Command shortcuts — single agent, instant execution
+/implement "add JWT auth middleware"
+/analyze "security review of payment module"
+/research "latest React Server Components patterns"
+
+# Single-CLI modes
+/tfx-codex "refactor + review"     # Codex only
+/tfx-gemini "implement + document"  # Gemini only
+```
+
+## Skills
+
+| Skill | Mode | Description |
+|-------|------|-------------|
+| `/tfx-auto` | Auto | Triage → decompose → parallel execute via DAG |
+| `/tfx-codex` | Codex-only | All CLI tasks routed to Codex |
+| `/tfx-gemini` | Gemini-only | All CLI tasks routed to Gemini |
+| `/tfx-setup` | Setup | File sync, HUD config, CLI diagnostics |
+
+### Command Shortcuts
+
+Bypass triage — instant single-agent execution:
+
+| Command | Agent | CLI | Use Case |
+|---------|-------|-----|----------|
+| `/implement` | executor | Codex | Code implementation |
+| `/build` | build-fixer | Codex | Build/type error fixes |
+| `/research` | document-specialist | Codex | Documentation lookup |
+| `/brainstorm` | analyst | Codex | Requirements analysis |
+| `/design` | architect | Codex | Architecture design |
+| `/troubleshoot` | debugger | Codex | Bug analysis |
+| `/cleanup` | executor | Codex | Code cleanup |
+| `/analyze` | quality + security | Codex | Parallel review (2 agents) |
+| `/spec-panel` | architect + analyst + critic | Codex | Spec review (3 agents) |
+| `/explain` | writer | Gemini | Code explanation |
+| `/document` | writer | Gemini | Documentation |
+| `/test` | test-engineer | Claude | Test strategy |
+| `/reflect` | verifier | Claude | Verification |
+
+## Architecture
+
+```
+User: "/tfx-auto refactor auth + improve UI + add tests"
+         |
+         v
+   [Phase 1: Parse] ─── Auto mode detected
+         |
+         v
+   [Phase 2a: Classify] ─── Codex (free)
+   │  auth refactor → codex
+   │  UI improvement → gemini
+   │  test addition  → claude
+         |
+         v
+   [Phase 2b: Decompose] ─── Opus (inline, no agent spawn)
+   │  t1: executor (implement, src/auth/)     Level 0
+   │  t2: designer (docs, src/components/)    Level 0
+   │  t3: test-engineer (Claude native)       Level 1 ← depends on t1
+         |
+         v
+   [Phase 3: Execute] ─── DAG parallel
+   │  Level 0: t1(Codex) + t2(Gemini)  ← parallel
+   │  Level 1: t3(Claude)               ← after t1 completes
+         |
+         v
+   [Phase 4-6: Collect → Retry → Report]
+```
+
+### Agent Routing Table
+
+| Agent | CLI | Effort | Timeout | Mode |
+|-------|-----|--------|---------|------|
+| executor | Codex | high | 360s | fg |
+| build-fixer | Codex | fast | 180s | fg |
+| debugger | Codex | high | 300s | bg |
+| deep-executor | Codex | xhigh | 1200s | bg |
+| architect | Codex | xhigh | 1200s | bg |
+| planner | Codex | xhigh | 1200s | fg |
+| critic | Codex | xhigh | 1200s | bg |
+| analyst | Codex | xhigh | 1200s | fg |
+| code-reviewer | Codex | thorough | 600s | bg |
+| security-reviewer | Codex | thorough | 600s | bg |
+| quality-reviewer | Codex | thorough | 600s | bg |
+| scientist | Codex | high | 480s | bg |
+| document-specialist | Codex | high | 480s | bg |
+| designer | Gemini Pro 3.1 | — | 600s | bg |
+| writer | Gemini Flash 3 | — | 600s | bg |
+| explore | Claude Haiku | — | 300s | fg |
+| verifier | Claude Sonnet | — | 300s | fg |
+| test-engineer | Claude Sonnet | — | 300s | bg |
+
+### Failure Handling
+
+1. **First failure** → Claude native agent fallback
+2. **Second failure** → Report failed subtask, continue with remaining results
+3. **Timeout** → Partial results reported
+
+<details>
+<summary><strong>Setup Guide</strong></summary>
+
+### Prerequisites
+
+- **Node.js** >= 18
+- **Claude Code** (required)
+- **Codex CLI** (optional): `npm install -g @openai/codex`
+- **Gemini CLI** (optional): `npm install -g @google/gemini-cli`
+
+> Without Codex or Gemini, triflux automatically falls back to Claude native agents.
+
+### Post-install
+
+```bash
+# Sync files + configure HUD
+tfx setup
+
+# Run diagnostics
+tfx doctor
+```
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `tfx setup` | Sync scripts + HUD + skills |
+| `tfx doctor` | CLI diagnostics + issue tracker |
+| `tfx update` | Update to latest version |
+| `tfx list` | List installed skills |
+| `tfx version` | Show version info |
+
+Shortcuts: `tfx` = `triflux`, `tfl` = `triflux`
+
+### HUD Status Bar
+
+Real-time monitoring in Claude Code's status line:
+
+- Claude / Codex / Gemini token usage and rate limits
+- CLI health indicators (installed, API key status)
+- Session cost tracking and savings report
+
+Configured automatically via `tfx setup`.
+
+</details>
+
+<details>
+<summary><strong>oh-my-claudecode Integration</strong></summary>
+
+triflux works standalone or as part of [oh-my-claudecode](https://github.com/nicepkg/oh-my-claudecode):
+
+- Skills auto-registered via OMC's plugin system
+- `cli-route.sh` integrates with OMC's agent catalog
+- HUD extends OMC's status line
+- Compatible with OMC autopilot, ralph, team, and ultrawork modes
+
+</details>
+
+<details>
+<summary><strong>Changelog</strong></summary>
+
+### 2.0.0
+
+- Rebranded from `cx-skills` to `triflux`
+- New CLI commands: `tfx`, `triflux`, `tfl`
+- Updated skills: `/tfx-auto`, `/tfx-codex`, `/tfx-gemini`, `/tfx-setup`
+- Visual refresh with amber branding
+- All internal references updated (`CX_CLI_MODE` → `TFX_CLI_MODE`)
+
+### Previous (cx-skills)
+
+See [cx-skills releases](https://github.com/tellang/cx-skills/releases) for v1.x history.
+
+</details>
+
+---
+
+<p align="center">
+  <a href="https://github.com/tellang/triflux">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tellang/triflux&type=Date&theme=dark">
+      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tellang/triflux&type=Date">
+      <img alt="Star History" src="https://api.star-history.com/svg?repos=tellang/triflux&type=Date" width="600">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <sub>MIT License · Made by <a href="https://github.com/tellang">tellang</a></sub>
+</p>

package/bin/tfx-doctor.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// tfx-doctor — triflux doctor 바로가기
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+process.argv = [process.argv[0], process.argv[1], "doctor", ...process.argv.slice(2)];
+await import("./triflux.mjs");

package/bin/tfx-setup.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// tfx-setup — triflux setup 바로가기
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+process.argv = [process.argv[0], process.argv[1], "setup", ...process.argv.slice(2)];
+await import("./triflux.mjs");