# raskrebs/sonar

CLI tool for inspecting and managing services listening on localhost ports

Repository: https://github.com/raskrebs/sonar
Canonical: https://ross.abutalabs.com/products/raskrebs-sonar
Language: Go
License: MIT
License Family: permissive
Topics: cli, developer-tools, docker, golang, linux, localhost, macos, portscanner, powershell
Last push: 2026-09-02T09:29:42+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 100, longevity 13
- inputs: {"age_days": 182, "days_push": 0, "days_rel": 0, "gap_med": 0.0, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1092, forks 34 (observed 2026-09-03T02:15:17.308813+00:00)

## What it is
Sonar is a Go-based CLI tool that shows all services listening on localhost ports, enriched with Docker container names, Compose projects, images, and resource usage. It lets developers kill processes, tail logs, and shell into containers directly by port number.

## Use cases
- find out what process is using port 3000
- see which docker container is listening on a localhost port
- kill the process occupying a port
- list all services running on my machine
- tail logs for a dev server by port
- shell into the container behind a port
- figure out why a port is already taken

## When to choose
- you frequently debug port conflicts during local development
- you work with Docker Compose and want port-to-container visibility
- you want a friendlier alternative to lsof/netstat for listening ports

## When to avoid
- you need remote or network-wide port scanning rather than localhost
- you need a GUI-based port management tool
- you are on a platform without Docker and only need basic lsof functionality

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, monitoring, container-runtime
- domain: developer-tools
- platform: windows, cli
- tags: port-scanner, localhost, docker-integration, process-management, go, command-line, containers, devops, macos, linux, docker

## Member repositories
- raskrebs/sonar (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:17.308813+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:49:19.489147+00:00, confidence not recorded.
  - readme: https://github.com/raskrebs/sonar (fetched 2026-09-03T02:15:17.308813+00:00, sha 7cb4e702b77a)
- Data as of 2026-08-30T08:39:29.467469+00:00.