tfx-hub

tfx-hub — MCP 메시지 버스 관리 + 개방형 작업

ARGUMENTS 처리: 이 스킬이 ARGUMENTS: <값>과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.

인프라: 다른 스킬이 내부적으로 사용. 직접 호출할 필요 없음. CLI 에이전트(Codex/Antigravity/Claude) 간 실시간 메시지 허브를 관리합니다. 커맨드 매칭 + fallthrough: start/stop/status에 매칭되면 즉시 실행, 매칭 안 되면 hub 도메인 컨텍스트를 활용한 범용 작업으로 처리합니다.

입력 해석 규칙

/tfx-hub start          → 커맨드 매칭 → 허브 시작
/tfx-hub stop           → 커맨드 매칭 → 허브 중지
/tfx-hub status         → 커맨드 매칭 → 상태 확인
/tfx-hub 테스트해줘      → fallthrough → hub 관련 범용 작업으로 처리
/tfx-hub 문서 저장해     → fallthrough → hub 관련 범용 작업으로 처리
/tfx-hub 브릿지 분석해   → fallthrough → hub 관련 범용 작업으로 처리

fallthrough 규칙: 인자가 start/stop/status/--port 등 커맨드 키워드에 매칭되지 않으면, 사용자의 입력을 hub/브릿지/메시지버스 도메인의 자유형 작업으로 해석한다.

fallthrough 라우팅:

# tfx-route.sh 경유 (권장)
Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{hub 컨텍스트 + 작업}' {mcp_profile}")

# codex 직접 호출 시 — 반드시 exec 서브커맨드 포함
Bash("codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
Bash("codex --profile gpt56_sol_xhigh exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
#          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에

# Claude 네이티브 (탐색/검증)
Agent(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="{작업}")

커맨드

start — 허브 시작

Bash("node hub/server.mjs", run_in_background=true)

• Streamable HTTP MCP 서버를 http://127.0.0.1:27888/mcp 에서 시작
• SQLite WAL DB: ~/.claude/cache/tfx-hub/state.db
• PID 파일: ~/.claude/cache/tfx-hub/hub.pid
• 환경변수: TFX_HUB_PORT (포트), TFX_HUB_DB (DB 경로)

stop — 허브 중지

# PID 파일에서 프로세스 ID 읽어서 종료
Bash("node -e \"
  const fs = require('fs');
  const path = require('path');
  const pidFile = path.join(require('os').homedir(), '.claude/cache/tfx-hub/hub.pid');
  if (fs.existsSync(pidFile)) {
    const info = JSON.parse(fs.readFileSync(pidFile, 'utf8'));
    process.kill(info.pid, 'SIGTERM');
    console.log('tfx-hub 종료 (PID ' + info.pid + ')');
  } else {
    console.log('tfx-hub 미실행');
  }
\"")