이 mod 소개
ts-band: Claude Code에서 Tailscale 노드 상태 보기
한국어 · 简体中文
입력 상자 위에 Tailscale 네트워크의 각 노드 연결 상태를 표시합니다. 모두 직접 연결일 때는 작은 마커만 차지하고, 중계 또는 오프라인 노드가 있을 때만 나열합니다. Claude가 원격 머신에 배포하거나 파일을 동기화하기 전에 링크가 정상인지 확인할 수 있습니다.
기능
- 정상일 때 거의 공간을 차지하지 않음: 모든 노드가 온라인이고 직접 연결일 때
TS ● 4/4 직접만 표시합니다. - 문제가 있을 때만 확장: 온라인 노드 수를 표시한 후, 주의가 필요한 노드만 나열:
◐노란색은 중계 또는 DERP(예:DERP-sfo와 같이 DERP 지역 표시),○빨간색은 오프라인. - 온라인/오프라인 알림: 노드가 온라인 또는 오프라인이 되면 토스트를 표시합니다.
- 적시 새로고침: 분당 한 번
tailscale status --json을 읽으며, Claude가tailscale up,down,set,switch,login,logout을 실행한 후 즉시 새로고침합니다. - 읽기 실패 시 지우지 않음: 읽기 실패 시 마지막 노드를 유지하고 오류 메시지를 뒤에 추가; 이후 재시도 간격은 매번 두 배로 증가(최대 10분), CLI가 설치되지 않았거나 데몬이 꺼져 있을 때 매번 재시도하지 않습니다.
claude -p및 SDK에서는 실행되지 않습니다.
설치
먼저 Tailscale을 설치하고 tailscale 명령을 사용할 수 있는지 확인합니다(macOS 앱에 포함된 CLI도 찾을 수 있음). 그런 다음:
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band@hoobnn-agent-mods
명령
/ts: 표시/숨기기 전환;/ts off,/ts on으로 직접 설정. 이 설정은/config에 기록되며 이후 세션에도 유지됩니다.
옵션
/config에서 수정하거나 ~/.claude/settings.json의 pluginConfigs에 작성합니다:
| 옵션 | 효과 | 기본값 |
| --- | --- | --- |
| visible | 밴드 표시(/ts가 전환하는 것) | 켜짐 |
| nodes | 이 노드들만 표시, 입력 순서대로 정렬; host=이름으로 표시 이름 변경 가능, 예: nas=집, dev-box, vps-west=미서부. 비워두면 모두 표시, 온라인 수와 알림도 선택한 노드만 계산 | 비어 있음 |
| hideOffline | 밴드에 오프라인 노드를 나열하지 않음(온라인 수에는 계속 포함) | 꺼짐 |
| tailscalePath | tailscale 명령의 경로; 비워두면 PATH, Homebrew, macOS 앱 순으로 검색 | 비어 있음 |
| intervalSeconds | 읽기 사이의 초(최소 10) | 60 |
| language | UI 언어: auto, en, zh-Hans, zh-Hant, ja, ko, es, fr, de, pt-BR, ru | auto |
language가 auto이면 Claude Code의 language 설정, 시스템 로케일 순으로 따르고, 둘 다 없으면 영어를 사용합니다.
같은 시리즈 mod
hoobnn-agent-mods에는 상태 표시줄 HUD(hud), 작업 진행 표시줄(todo-bar), 턴 영수증(receipt), 실행 애니메이션과 펫(spinner), 그리고 히토코토(hitokoto)도 있어 함께 사용할 수 있습니다.
개발
hooks/register.tsx: 훅(세션 시작 시 언어,/ts및 정기 읽기, 명령 및 밴드).hooks/config.ts: 옵션, 한 번에 타입이 지정된Config로 읽기.hooks/parse.ts:tailscale status --json을 노드로 파싱하고,nodes옵션을 필터 규칙으로 파싱.hooks/i18n.ts: 각 언어 텍스트.hooks/kit/:claude-code/kit의 복사본; 소스 파일 수정 후scripts/sync-kit.sh실행.
