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는 자체 백그라운드 셸과 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 자체의 백그라운드 셸이 이를 나열하고 중지합니다. - 중지는 버튼을 누른 뒤 백그라운드에서 실행되므로, 느린 중지(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.
