MichaelP17/claude-mods/tree/main/service-radar
service-radar
Claude Code の外部プラグイン:Bash で Claude が起動した常駐サービス(docker compose、colima、brew services、launchctl)を追跡し、`/services` パネルから停止または実行継続を選べます。
この 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,envand similar prefixes and when sent to the background with&. Other programs sent to the background, such asnpm 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.
