hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band

hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band

한국어 · English
입력창 위에 Tailscale 네트워크의 각 노드 연결 상태를 표시합니다. 모두 직접 연결되어 있으면 작은 표시 하나만 보이고, 중계 경로를 사용하거나 오프라인인 노드가 있을 때만 목록을 펼칩니다. Claude가 원격 시스템에 배포하거나 파일을 동기화하기 전에 경로가 정상인지 확인할 수 있습니다.

TS ● 4/4 직접 연결만 표시합니다.◐ 노란색은 중계 또는 DERP를 뜻하며(예: DERP-sfo처럼 DERP 영역 표시), ○ 빨간색은 오프라인입니다.tailscale status --json을 매분 읽고 Claude가 tailscale up, down, set, switch, login, logout을 실행한 뒤 즉시 갱신합니다.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 설정과 시스템 언어 환경을 차례로 따르며, 둘 다 없으면 영어를 사용합니다.
hoobnn-agent-mods에는 상태 표시줄 HUD(hud), 작업 진행률 표시줄(todo-bar), 턴 영수증(receipt), 동작 애니메이션과 펫(spinner), 한마디(hitokoto)도 있어 함께 사용할 수 있습니다.
hooks/register.tsx: hook(세션 시작 시 언어, /ts와 주기적 읽기, 명령, 막대).hooks/config.ts: 옵션을 타입이 지정된 Config로 한 번 읽습니다.hooks/parse.ts: tailscale status --json을 노드로 파싱하고 nodes 옵션을 필터 규칙으로 파싱합니다.hooks/i18n.ts: 언어별 문구.hooks/kit/: claude-code/kit의 복사본이며 소스 파일을 바꾼 뒤 scripts/sync-kit.sh를 실행합니다.먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install ts-band@hoobnn-agent-mods
简体中文 · English
在输入框上方显示 Tailscale 组网里各节点的连接状态。全部直连时只占一个小标记;有节点走中继或掉线时才把它们列出来。让 Claude 往远程机器部署、同步文件之前,先看一眼链路是否正常。

TS ● 4/4 直连。◐ 黄色表示走中继或 DERP(会标出 DERP 区域,如 DERP-sfo),○ 红色表示离线。tailscale status --json;Claude 执行 tailscale up、down、set、switch、login、logout 后立即刷新。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 | 界面语言:auto、en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru | auto |
language 为 auto 时,依次跟随 Claude Code 的 language 设置和系统语言环境,都没有时用英语。
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。내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.