tfx-remotelisted
Install: claude install-skill tellang/triflux
# tfx-remote — remote consolidated entrypoint
`tfx-remote`는 신규 원격 엔진이 아니라 기존 `tfx-remote-setup` + `tfx-remote-spawn`
표면을 한 명령군으로 축소한 통합 진입점이다.
## Public subcommands
| 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로만 유지한다.
## Dispatch contract
### `tfx-remote setup`
기존 `tfx-remote-setup` 플로우를 그대로 사용한다.
- `setup`
- `setup --add`
- `setup --edit`
- `setup --probe-all`
- `setup --diagnose`
`hosts.json` 은 user-state 경로 한 곳만 읽고 쓴다.
- macOS/Linux: `~/.config/triflux/hosts.json`
- Windows: `%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를 먼저 수행한다.
1. user-state `hosts.json` 존재 확인
2. 호스트명/alias 해석
3. probe TTL 확인
4. SSH 실패 시 `setup diagnose` 또는 `setup edi