---
name: tfx-remote-spawn
description: >
  legacy thin alias. Phase 4b부터 spawn/list/attach/send/resume/kill/probe 공용 진입점은
  tfx-remote 이다.
triggers:
  - tfx-remote-spawn
argument-hint: "[spawn|list|attach|send|resume|kill|probe] ..."
---

# tfx-remote-spawn — legacy alias

이 스킬은 Phase 4b thin alias다. 새 표면은 `tfx-remote` 명령군이다.

## hosts.json location

호스트 별칭/설정은 canonical `tfx-remote` 와 동일하게 user-state 경로 한 곳만 사용한다.
- macOS/Linux: `~/.config/triflux/hosts.json`
- Windows: `%APPDATA%\triflux\hosts.json`

기존 `references/hosts.json` 및 source/packages/global fan-out는 더 이상 사용하지 않는다.
첫 실행 시 legacy `references/hosts.json` 이 발견되면 lazy auto-migration으로 user-state 경로에 자동 이동된다.

## Deprecation logging (alias 호출 즉시 실행 필수)

canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존.

```bash
mkdir -p .omc/state
echo "[deprecated] tfx-remote-spawn -> use: tfx-remote" >&2
echo "[DEPRECATED] tfx-remote-spawn — see tfx-remote"
echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-remote-spawn -> tfx-remote" >> .omc/state/alias-usage.log
```

## Alias mapping

- `tfx-remote-spawn <host> [prompt]` → `tfx-remote spawn <host> [prompt]`
- `tfx-remote-spawn --list` → `tfx-remote list`
- `tfx-remote-spawn --attach <session>` → `tfx-remote attach <session>`
- `tfx-remote-spawn --send <session> "<msg>"` → `tfx-remote send <session> "<msg>"`
- `tfx-remote-spawn --probe <host>` → `tfx-remote probe <host>`
- 최근 세션 복귀/호스트 기반 재개 → `tfx-remote resume <session|host|recent>`
- 세션 종료 → `tfx-remote kill <session>`

## Parity note

`capture` / `wait`는 public consolidation 대상이 아니다. 기존 parity가 필요하면
legacy passthrough 또는 내부 debug 표면으로만 유지한다.

새 문서나 사용자 안내에서 `tfx-remote-spawn`을 1급 표면처럼 홍보하지 않는다.