version: "1.0.1" name: tfx-setup description: triflux 초기 설정 및 진단을 수행합니다. triggers:

• tfx-setup

argument-hint: "[doctor]"

tfx-setup — triflux 초기 설정 및 진단

설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.

사용법

/tfx-setup
/tfx-setup doctor    ← 진단만 실행

동작

기본 모드 (/tfx-setup)

1. 파일 동기화 — triflux setup 실행
2. HUD 설정 — settings.json에 statusLine 자동 등록
3. CLI 진단 — triflux doctor 실행
4. 결과 보고 — 설정 상태 요약

진단 모드 (/tfx-setup doctor)

triflux doctor만 실행하고 결과를 보고합니다.

실행 방법

Step 1: 파일 동기화

Bash("triflux setup")

Step 2: HUD 설정 확인 및 적용

~/.claude/settings.json을 읽어 statusLine 설정을 확인합니다.

statusLine이 없거나 hud-qos-status.mjs를 가리키지 않는 경우:

// settings.json에 추가할 statusLine 설정
{
  "statusLine": {
    "type": "command",
    "command": "\"<NODE_PATH>\" \"<HOME>/.claude/hud/hud-qos-status.mjs\""
  }
}

• <NODE_PATH>: node -e "console.log(process.execPath)" 결과
• <HOME>: ~ 또는 홈 디렉토리 절대 경로
• Windows: 경로에 공백이 있으면 큰따옴표로 감싸기
• 기존 statusLine이 있으면 덮어쓰기 전 사용자에게 확인

Read 도구로 ~/.claude/settings.json을 읽고, Edit 도구로 statusLine을 추가/수정합니다.

Step 3: CLI 진단

Bash("triflux doctor")

Step 4: 결과 보고

## tfx-setup 완료
 
| 항목 | 상태 |
|------|------|
| tfx-route.sh | ✅ v2.0 |
| HUD (hud-qos-status.mjs) | ✅ v1.7 |
| HUD 설정 (settings.json) | ✅ statusLine 등록됨 |
| Codex CLI | ✅ / ⚠️ 미설치 (선택) |
| Gemini CLI | ✅ / ⚠️ 미설치 (선택) |
| 스킬 | ✅ N개 설치됨 |
 
### 다음 단계
-Codex 미설치 시: `npm install -g @openai/codex`
-Gemini 미설치 시: `npm install -g @google/gemini-cli`
-세션 재시작하면 HUD가 표시됩니다

에러 처리

Troubleshooting

문제 발생 시 /tfx-doctor 실행. (--fix 자동 수정, --reset 캐시 초기화)