Menú
원격 관련 표면을 setup/spawn 계열 하나로 통합한 엔트리포인트. setup, spawn, list, attach, send, resume, kill, probe 하위 명령을 기준으로 기존 tfx-remote-setup/tfx-remote-spawn 흐름을 축소 통합한다.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고 canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.
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.
CLI 프로젝트의 setup/postinstall 흐름에 GitHub 스타 요청을 추가한다. 'star prompt', '스타 요청', '리포 스타', 'star request', '깃헙 스타 넣어줘', 'star 눌러달라고', '응원 요청' 같은 요청에 사용한다.
코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 반드시 사용.
통합 CLI 오케스트레이터이자 실행 스킬 front door. 단일/병렬 구현·수정 작업을 자동 분류해 Codex 우선으로 dispatch 하고, 명시 플래그로 mode/parallel/consensus 등 동작을 오버라이드한다. '코드 짜줘', '구현해줘', '만들어줘', '수정해줘', '고쳐줘', 'implement', 'build', 'fix' 같은 구현/수정 요청에 사용. 플래그 상세는 argument-hint, 라우팅 정책은 .claude/rules/tfx-routing.md 참조.
triflux 진단 및 수리 도구. AskUserQuestion 기반 인터랙티브 선택지로 CLI 미발견, HUD 미표시, 캐시 오류, 스킬 미설치 등을 진단하고 자동 수정합니다. Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset, doctor
| name | tfx-remote |
| description | 원격 관련 표면을 setup/spawn 계열 하나로 통합한 엔트리포인트. setup, spawn, list, attach, send, resume, kill, probe 하위 명령을 기준으로 기존 tfx-remote-setup/tfx-remote-spawn 흐름을 축소 통합한다. |
| argument-hint | [setup|spawn|list|attach|send|resume|kill|probe] ... |
tfx-remote는 신규 원격 엔진이 아니라 기존 tfx-remote-setup + tfx-remote-spawn
표면을 한 명령군으로 축소한 통합 진입점이다.
| Subcommand | 역할 | legacy 매핑 |
|---|---|---|
setup | hosts 등록/편집/진단/probe-all | tfx-remote-setup |
spawn <host> [prompt] | 원격/로컬 세션 생성 | tfx-remote-spawn |
list | 활성 세션 목록 | tfx-remote-spawn --list |
attach <session> | 세션 재부착 | tfx-remote-spawn --attach |
send <session> "<msg>" | 세션에 후속 프롬프트 전송 | tfx-remote-spawn --send |
| `resume <session | host | recent>` |
kill <session> | 세션 종료 | legacy kill 동작 공식 승격 |
probe <host> | SSH/Tailscale/Claude 연결 체크 | tfx-remote-setup / tfx-remote-spawn --probe |
capture / wait는 Phase 4b public consolidation 대상이 아니다.
필요하면 legacy passthrough로만 유지한다.
tfx-remote setup기존 tfx-remote-setup 플로우를 그대로 사용한다.
setupsetup --addsetup --editsetup --probe-allsetup --diagnosehosts.json 은 user-state 경로 한 곳만 읽고 쓴다.
~/.config/triflux/hosts.json%APPDATA%\triflux\hosts.json기존 references/hosts.json 및 source/packages/global 3곳 fan-out 단계는 더 이상 사용하지 않는다.
첫 실행 시 legacy references/hosts.json 이 발견되면 lazy auto-migration으로 user-state 경로에 자동 이동된다.
tfx-remote spawn기존 tfx-remote-spawn 플로우를 사용하되 아래 preflight를 먼저 수행한다.
hosts.json 존재 확인setup diagnose 또는 setup edit 복귀 경로 제시preflight 실패 시 중단만 하지 말고 아래 중 하나로 복귀시킨다.
tfx-remote setup --addtfx-remote setup --edittfx-remote setup --diagnosetfx-remote probe <host>tfx-remote resume우선순위는 아래와 같다.
recent 또는 생략이면 최근 세션 우선, 없으면 default_host 기준 새 spawntfx-remote kill공식 public subcommand다. 세션 종료 전에 psmux/WT 정리 규칙은
.claude/rules/tfx-psmux.md와 AGENTS.md의 detach-first 정책을 따른다.
신규 코드는 가능하면 hub/lib/hosts-compat.mjs를 기준으로 해석한다.
저장 위치는 macOS/Linux ~/.config/triflux/hosts.json, Windows %APPDATA%\triflux\hosts.json 이다.
os, ssh_user, tailscale.ip, tailscale.dns, capabilitiesssh.user, capabilities_v2, last_proberesolveHost(nameOrAlias) 기준으로 alias, tailscale DNS/IP, ssh_user@host를
canonical host로 정규화한다.
허용 범위 안에서 Phase 4b가 완료되었는지 확인할 때 최소 검증은 아래와 같다.
node hub/lib/hosts-compat.mjs --self-testGet-FileHash .claude/rules/tfx-psmux.md, AGENTS.mdtfx-remote 또는 rule 문서로 위임되는지 확인