ClaudeMods
☰
JA
● 0 人がオンライン ・閲覧 0 回
スポンサー作品を投稿
GitHub リポジトリ · 投稿者 MichaelP17

service-radar

Claude Code の外部プラグイン:Bash で Claude が起動した常駐サービス(docker compose、colima、brew services、launchctl)を追跡し、`/services` パネルから停止または実行継続を選べます。

MichaelP17@MichaelP17

MichaelP17/claude-mods/tree/main/service-radar

翻訳済み

この mod について

service-radar

Claude がバックグラウンドで起動し、コマンドの終了後も動き続けるサービス——Docker Compose のスタック、コンテナ、Colima VM、Homebrew サービス——を追跡して停止できます。

Claude Code は自分のバックグラウンド shell と subagent はすでに一覧表示します。表示されないのは、切り離されて動き続けるサービスです。docker compose up -d はすぐ戻りますが、スタックは気付かないまま動き続けます。この mod はその隙間を埋め、それ以外では表に出ません。

| 状況 | 表示されるもの | | --- | --- | | Claude が起動したものが何も動いていない | 何も表示しない | | 何かが動いている | ステータス行に services 2 と 1 件表示 | | 詳細を見たい | /services がパネルを開く:名前、フォルダー、開始時刻、サービスごとの Stop ボタン、Stop all、Refresh | | 動作中に /clear | サービス一覧のダイアログ:Stop all または Keep running | | 以前のセッションのサービスが残ったまま新しいセッションが始まる | /services を指す toast |

設定は不要です。

追跡対象

| 起動方法 | 停止方法 | 実行確認 | | --- | --- | --- | | docker compose up -d(docker-compose も含む) | 同じフォルダーで、同じ -f、-p、--profile フラグを使う docker compose down | docker compose ps | | docker compose start | コンテナを残す docker compose stop | docker compose ps | | docker run -d | docker stop <name or id> | docker ps | | docker start <name> | docker stop <name> | docker ps | | colima start [profile] | colima stop [profile] | colima status | | brew services start / run / restart | brew services stop | brew services info --json | | launchctl load | launchctl unload | なし——? と Forget ボタンで表示 | | launchctl bootstrap <domain> <plist> | launchctl bootout <domain> <plist> | なし——? と Forget ボタンで表示 |

先頭に cd がある場合を含め、連結コマンドでもサービスを照合します。cd app && docker compose up -d なら、スタックは app で追跡されます。端末で自分が停止した場合や、Claude が停止コマンドを実行した場合など、別の方法で停止されたサービスは、次の確認時に一覧から消えます。

詳細と制限

  • サービスはセッションより長く存続するため、一覧はセッションをまたいで保持されます。Claude Code を終了するとダイアログを表示できないので、次のセッションで通知します。
  • 対象になるのは Claude が Bash ツール経由で実行したコマンドだけです。自分で起動したサービスは一覧に出ません。
  • 追跡対象の起動は sudo、nohup、env などの前置きの後ろにあっても、& でバックグラウンドに送られても認識されます。npm run dev & のような他のプログラムは追跡されません。Claude Code 自身のバックグラウンド shell がそれらを一覧表示し、停止します。
  • 停止はボタンを押した後にバックグラウンドで実行されるため、遅い停止(Colima は約 十秒)でも途中で打ち切られません。
  • 確認には 20 秒のタイムアウトがあり、セッション開始を遅らせません。

アンインストール

CLAUDE_CODE_PLUGIN_DIRS から mod を削除します。追跡していたサービスは動き続けるため、不要なら先に /services で停止してください。

インストール

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

claude plugin marketplace add MichaelP17/claude-mods
claude plugin install service-radar
原文 / README

service-radar

Keeps track of services Claude starts in the background and that keep running after the command returned — a Docker Compose stack, a container, the Colima VM, a Homebrew service — and lets you stop them.

Claude Code already lists its own background shells and subagents. What it does not show is a service that detaches: docker compose up -d returns at once, and the stack keeps running unnoticed. This mod fills that gap and stays out of sight otherwise.

| When | What you see | | --- | --- | | Nothing Claude started is running | nothing | | Something is running | one status line entry, services 2 | | You want details | /services opens a pane: name, folder, start time, a Stop button per service, Stop all, Refresh | | /clear while something runs | a dialog listing the services: Stop all or Keep running | | A new session starts while services from an earlier one still run | a toast pointing to /services |

No setup needed.

What is tracked

| Started with | Stopped with | Running check | | --- | --- | --- | | docker compose up -d (also docker-compose) | docker compose down in the same folder, with the same -f, -p and --profile flags | docker compose ps | | docker compose start | docker compose stop, which keeps the containers | docker compose ps | | docker run -d | docker stop <name or id> | docker ps | | docker start <name> | docker stop <name> | docker ps | | colima start [profile] | colima stop [profile] | colima status | | brew services start / run / restart | brew services stop | brew services info --json | | launchctl load | launchctl unload | none — shown with ? and a Forget button | | launchctl bootstrap <domain> <plist> | launchctl bootout <domain> <plist> | none — shown with ? and a Forget button |

Services are matched in chained commands too, including a preceding cd: in cd app && docker compose up -d the stack is tracked in app. A service that was stopped some other way — by you in a terminal, or by Claude running the stop command — drops off the list the next time it is checked.

Details and limits

  • The list is kept across sessions, because services outlive them. Exiting Claude Code cannot show a dialog, so the next session reminds you instead.
  • Only commands Claude runs through its Bash tool are seen. Services you start yourself are not listed.
  • A tracked start is recognised behind sudo, nohup, env and similar prefixes and when sent to the background with &. Other programs sent to the background, such as npm run dev &, are not tracked; Claude Code's own background shells list and stop those.
  • Stopping runs in the background after a press, so a slow stop (Colima takes about ten seconds) is never cut short.
  • Checks run with a 20-second timeout and never delay the start of a session.

Uninstall

Remove the mod from CLAUDE_CODE_PLUGIN_DIRS. Services it tracked keep running; stop them first with /services if you want them gone.

関連作品