關於這個 mod
ts-band:在 Claude Code 裡看 Tailscale 節點狀態
繁體中文 · English
在輸入框上方顯示 Tailscale 網路裡各節點的連線狀態。全部直連時只佔一個小標記;有節點走中繼或離線時才把它們列出來。讓 Claude 往遠端機器部署、同步檔案之前,先看一下鏈路是否正常。

功能
- 正常時幾乎不佔地方:所有節點在線且直連時,只顯示
TS ● 4/4 直連。 - 有異常才展開:顯示在線節點數,然後只列出需要注意的節點:
◐黃色表示走中繼或 DERP(會標出 DERP 區域,如DERP-sfo),○紅色表示離線。 - 上線 / 離線提醒:節點上線或離線時彈 toast。
- 及時重新整理:每分鐘讀一次
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 | 介面語言: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。
