Remote
infra/remotes/*.yaml に定義されたリモートマシンを管理します。
参照ファイルはトリガーされた場合のみ読み込んでください。
ガード
bridge-config.yaml で remotes.enabled が true である必要があります。そうでない場合は、その旨を伝えて終了します。
引数
| 引数 | 効果 | デフォルト |
|---|---|---|
(なし) | 全リモートのダッシュボード | — |
{hostname} | 1台のリモートの詳細表示 | — |
health {hostname} | SSHヘルスチェック | — |
logs {hostname} {service} | 最近のログを表示 | — |
restart {hostname} {service} | サービスを再起動 | — |
sync {hostname} | 設定ファイルを同期 | — |
wake {hostname} | Wake-on-LAN | — |
connect {hostname} | SSH / RDPセッションを開く | — |
shutdown {hostname} | 電源オフ（[y] が必要） | — |
reboot {hostname} | マシンを再起動（[y] が必要） | — |
決定木
ユーザーがしたいこと...
├── リモートの概要 / ダッシュボード → references/workflow.md (§ ダッシュボード) を参照
├── 1台のマシンの詳細表示 → references/workflow.md (§ ダッシュボード、単一ホスト) を参照
├── マシンを起動 / 電源オン → references/fleet.md (§ ステージ3 WoL) を参照
├── SSH / RDPで接続 → references/fleet.md (§ ステージ4 接続) を参照
├── 再起動またはシャットダウン → references/fleet.md (§ ステージ5) を参照
├── 到達可能性 / オンライン確認 → references/fleet.md (§ ステージ2) を参照
├── 変更後のインベントリ更新 → references/fleet.md (§ ステージ6) を参照
├── マシンのヘルスチェック → references/workflow.md (§ ヘルスチェック) を参照
├── サービスのログ表示 → references/workflow.md (§ ログ) を参照
├── サービスの再起動 → references/workflow.md (§ 再起動) を参照
├── リモートへの設定同期 → references/workflow.md (§ 同期) を参照
├── リモートへのサービスデプロイ → references/workflow.md (§ デプロイ) を参照
├── 「自分のPC」を特定 / 意図のみ → references/fleet.md (§ ステージ1 + 学習済みルーティング) を参照
└── リモートに関する質問 → CLAUDE.md § リモートから回答
参照マップ
| ファイル | 担当 |
|---|---|
references/fleet.md | インベントリ、WoL、接続、シャットダウン、到達可能性、「自分のPC」ルーティング |
references/workflow.md | サービスダッシュボード、ヘルス、ログ、再起動、同期、デプロイ |
ハードルール（譲れないもの）
- Tailscale優先、LANはフォールバック — LANはVPNや外部ネットワークでは機能しません
- 破壊的操作（シャットダウン、再起動、フォーマット）には操作ごとに
[y]が必要 - 認証情報は決して
infra/remotes/*.yamlに保存しない — KeyVault / 1PasswordのURIのみ wake_on_lan.enabled: falseを尊重する — オプトアウトしたマシンを強制的に起動しない- 操作の前に
infra/remotes/{target}.yamlを読む — 推測しない