iximiuz/cdebug

Health v2 · maintenance only

Adoption not part of the score

1666 stars · 67 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

cdebug is a statically linked Go CLI that acts as a swiss army knife for debugging containers and pods, especially those built from slim or distroless images lacking shells and tools. It injects a debugging sidecar that shares the target's filesystem, and supports port forwarding and filesystem export across Docker, containerd, and Kubernetes.

Use cases

• debug a distroless container with no shell
• get an interactive shell into a slim container
• exec into a containerd container without nerdctl tooling
• start a debug shell in a Kubernetes pod
• forward unpublished container ports to the host
• expose host endpoints to container or Kubernetes networks
• export a container or image filesystem to a local folder

When to choose

• you need to troubleshoot running containers that lack shell or debugging tools
• you work across Docker, containerd, and Kubernetes and want one debugging tool
• you want ephemeral debug sidecars that feel like docker exec
• you need quick port-forwarding or filesystem export for containers

When to avoid

• you only use Podman, OCI runc/crun, or CRI runtimes where support is missing or incomplete
• you need a GUI or long-running monitoring solution rather than an on-demand debugging tool
• your platform is Windows (only linux/amd64 and darwin builds are provided)

Facets

cli-tool · maturity active

developer-tools cli developer-tools cli container-debugging distroless ephemeral-containers port-forwarding sidecar docker containerd kubernetes containers devops command-line linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="iximiuz/cdebug")