ClaudeMods
☰
KO
● 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는 자체 백그라운드 셸과 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, 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.

비슷한 프로젝트