ClaudeModsClaude Code mod ディレクトリ
☰
● 0 人がオンライン ・閲覧 0 回
+ 作品を投稿
← 作品一覧へ
GitHub リポジトリ · Git・コードレビュー

ts-band — Claude Code プラグイン · ClaudeMods

この作品を報告あなたの作品ですか?所有者確認へ

ClaudeMods でこの Claude Code プラグインのソースと必要な権限を確認できます。 ts-band:プロンプトの上にバンドで Tailscale ノードの状態を表示し、ノードがオンライン/オフラインになるとトーストを表示

hhoobnn@hoobnn
元の投稿の画像1
翻訳済み

この mod について

ts-band:Claude Code で Tailscale ノードの状態を確認

日本語 · 简体中文

入力ボックスの上に Tailscale ネットワーク内の各ノードの接続状態を表示します。すべて直接接続のときは小さなマーカーだけを占有し、中継またはオフラインのノードがあるときだけそれらをリスト表示します。Claude にリモートマシンへのデプロイやファイル同期を依頼する前に、リンクが正常かどうかを確認できます。

ts-band:2つのノードが中継、1つのノードがオフライン

機能

  • 正常時はほとんど場所を取らない:すべてのノードがオンラインかつ直接接続のとき、TS ● 4/4 直接 のみを表示。
  • 異常時のみ展開:オンラインノード数を表示し、注意が必要なノードだけをリスト表示:◐ 黄色は中継または DERP(DERP リージョンを表示、例:DERP-sfo)、○ 赤色はオフライン。
  • オンライン/オフライン通知:ノードがオンラインまたはオフラインになったときにトーストを表示。
  • 適時更新:毎分 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 を実行。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band
原文 / 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。
元のソースを見る ↗

関連作品