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

機能
- 正常時はほとんど場所を取らない:すべてのノードがオンラインかつ直接接続のとき、
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を実行。
