tfx-hub

Estrelas7

Forks2

Atualizado17 de julho de 2026 às 05:06

tfx-hub 개방형 스킬 — 커맨드(start/stop/status) + 자유형 작업 모두 처리

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

tellang

tellang/triflux

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

SKILL.md

readonly

name	tfx-hub
description	tfx-hub 개방형 스킬 — 커맨드(start/stop/status) + 자유형 작업 모두 처리
triggers	["tfx-hub"]
argument-hint	<start\|stop\|status\|자유형 작업 설명>

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

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 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 미실행');
  }
\"")

status — 상태 확인

# HTTP 상태 엔드포인트 조회
Bash("curl -s http://127.0.0.1:27888/status 2>/dev/null || echo '{\"error\":\"hub 미실행\"}'")

각 CLI 등록 방법

허브 시작 후 각 CLI에 MCP 서버로 등록:

# Codex
codex mcp add tfx-hub --url http://127.0.0.1:27888/mcp

# Gemini (settings.json)
# mcpServers.tfx-hub.url = "http://127.0.0.1:27888/mcp"

# Claude
claude mcp add --transport http tfx-hub http://127.0.0.1:27888/mcp

MCP 도구 (8개)

도구	설명
`register`	에이전트 등록 + lease 발급
`status`	허브/에이전트/큐 상태 조회
`publish`	이벤트/응답 메시지 발행
`ask`	다른 에이전트에게 질문 (request/reply)
`poll_messages`	수신함에서 메시지 폴링
`handoff`	작업 인계
`request_human_input`	사용자 입력 요청 (CAPTCHA/승인)
`submit_human_input`	사용자 입력 응답

브릿지 REST 엔드포인트 (4개)

엔드포인트	설명
`POST /bridge/register`	에이전트 등록 (프로세스 수명 기반 lease)
`POST /bridge/result`	결과 발행 (topic fanout)
`POST /bridge/context`	선행 컨텍스트 폴링 (auto_ack)
`POST /bridge/deregister`	에이전트 offline 마킹

프로젝트 구조

hub/
├── server.mjs    # MCP 서버 + REST 브릿지 엔드포인트
├── store.mjs     # SQLite WAL 상태 저장소
├── router.mjs    # Actor mailbox 라우터 + QoS
├── tools.mjs     # MCP 도구 8개 정의
├── hitl.mjs      # Human-in-the-Loop 매니저
├── bridge.mjs    # tfx-route.sh ↔ hub 브릿지 CLI
└── schema.sql    # DB 스키마

상태

dev 전용 — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.

Mais deste repositório

mesmo repositório

tfx-harness

tellang/triflux

어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고 canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.

2026-07-277

tfx-live

tellang/triflux

Use when Claude, Codex, or a Triflux worker needs live Claude↔Codex orchestration: start/ask/stop, multi-turn, peer relay, daemon UDS attach, or UDS-first with tmux fallback.

2026-07-237

star-prompt

tellang/triflux

CLI 프로젝트의 setup/postinstall 흐름에 GitHub 스타 요청을 추가한다. 'star prompt', '스타 요청', '리포 스타', 'star request', '깃헙 스타 넣어줘', 'star 눌러달라고', '응원 요청' 같은 요청에 사용한다.

2026-07-207

tfx-analysis

tellang/triflux

코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 반드시 사용.

2026-07-207

tfx-auto

tellang/triflux

통합 CLI 오케스트레이터이자 실행 스킬 front door. 단일/병렬 구현·수정 작업을 자동 분류해 Codex 우선으로 dispatch 하고, 명시 플래그로 mode/parallel/consensus 등 동작을 오버라이드한다. '코드 짜줘', '구현해줘', '만들어줘', '수정해줘', '고쳐줘', 'implement', 'build', 'fix' 같은 구현/수정 요청에 사용. 플래그 상세는 argument-hint, 라우팅 정책은 .claude/rules/tfx-routing.md 참조.

2026-07-207

tfx-doctor

tellang/triflux

triflux 진단 및 수리 도구. AskUserQuestion 기반 인터랙티브 선택지로 CLI 미발견, HUD 미표시, 캐시 오류, 스킬 미설치 등을 진단하고 자동 수정합니다. Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset, doctor

2026-07-207

name	tfx-hub
description	tfx-hub 개방형 스킬 — 커맨드(start/stop/status) + 자유형 작업 모두 처리
triggers	["tfx-hub"]
argument-hint	<start\|stop\|status\|자유형 작업 설명>

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

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 라우팅:

# 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 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 미실행');
  }
\"")

status — 상태 확인

# HTTP 상태 엔드포인트 조회
Bash("curl -s http://127.0.0.1:27888/status 2>/dev/null || echo '{\"error\":\"hub 미실행\"}'")

각 CLI 등록 방법

허브 시작 후 각 CLI에 MCP 서버로 등록:

# Codex
codex mcp add tfx-hub --url http://127.0.0.1:27888/mcp

# Gemini (settings.json)
# mcpServers.tfx-hub.url = "http://127.0.0.1:27888/mcp"

# Claude
claude mcp add --transport http tfx-hub http://127.0.0.1:27888/mcp

MCP 도구 (8개)

도구	설명
`register`	에이전트 등록 + lease 발급
`status`	허브/에이전트/큐 상태 조회
`publish`	이벤트/응답 메시지 발행
`ask`	다른 에이전트에게 질문 (request/reply)
`poll_messages`	수신함에서 메시지 폴링
`handoff`	작업 인계
`request_human_input`	사용자 입력 요청 (CAPTCHA/승인)
`submit_human_input`	사용자 입력 응답

브릿지 REST 엔드포인트 (4개)

엔드포인트	설명
`POST /bridge/register`	에이전트 등록 (프로세스 수명 기반 lease)
`POST /bridge/result`	결과 발행 (topic fanout)
`POST /bridge/context`	선행 컨텍스트 폴링 (auto_ack)
`POST /bridge/deregister`	에이전트 offline 마킹

프로젝트 구조

hub/
├── server.mjs    # MCP 서버 + REST 브릿지 엔드포인트
├── store.mjs     # SQLite WAL 상태 저장소
├── router.mjs    # Actor mailbox 라우터 + QoS
├── tools.mjs     # MCP 도구 8개 정의
├── hitl.mjs      # Human-in-the-Loop 매니저
├── bridge.mjs    # tfx-route.sh ↔ hub 브릿지 CLI
└── schema.sql    # DB 스키마

상태

dev 전용 — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.