ClaudeMods
☰
ZH-TW
● — 人在線上 · 瀏覽 — 次
贊助提交作品
GitHub 儲存庫 · 發布者 hoobnn

ts-band

ts-band:在提示列上方用橫條顯示 Tailscale 節點狀態,節點上線或離線時顯示提示

hoobnn@hoobnn

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

圖片1
已翻譯

關於這個 mod

ts-band:在 Claude Code 中查看 Tailscale 節點狀態

繁體中文 · English

在輸入框上方顯示 Tailscale 組網中各節點的連線狀態。所有節點都直連時只佔一個小標記;有節點經過中繼或離線時,才會列出來。讓 Claude 往遠端機器部署或同步檔案前,先看一眼連線是否正常。

ts-band:兩個節點經過中繼,一個節點離線

功能

  • 正常時幾乎不佔空間:所有節點上線且直連時,只顯示 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。

安裝

請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band@hoobnn-agent-mods
原文 / README

ts-band:在 Claude Code 里看 Tailscale 节点状态

简体中文 · English

在输入框上方显示 Tailscale 组网里各节点的连接状态。全部直连时只占一个小标记;有节点走中继或掉线时才把它们列出来。让 Claude 往远程机器部署、同步文件之前,先看一眼链路是否正常。

ts-band:两个节点走中继,一个节点离线

功能

  • 正常时几乎不占地方:所有节点在线且直连时,只显示 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。

取得徽章

這是你的專案嗎?把這個徽章放進 README 或網站,連回本頁。

Featured on ClaudeMods
尺寸
配色
Markdown
HTML

更多類似作品