🦆 duck

A terminal UI for Docker: live container tree, aggregated stack logs, and interactive exec — event-driven, no polling.

Features

• Event-driven: watches the Docker events API for container state changes. No polling loop.
• Stacks as first-class citizens: containers are grouped by com.docker.compose.project / com.docker.compose.service labels, so a compose stack shows as a tree, not a flat list.
• Aggregated live logs: select a stack to follow every container's logs in one merged, color-coded-per-container stream (via sonirico/vago/streams).
• Interactive exec with native tmux integration: press e on a container to open a shell. Inside tmux >= 3.2 it opens a popup, >= 3.0 a split pane, otherwise it falls back to an inline docker exec.
• Correct stdout/stderr demuxing: logs are demultiplexed with stdcopy, so non-TTY containers render cleanly.
• Volumes tab: press 2 to list volumes with drivers and usage; unused volumes can be deleted with a y/n confirmation.
• Networks tab: press 3 to list networks with driver, subnet and usage; unused non-builtin networks can be deleted with a y/n confirmation.
• Images tab: press 4 to list images with repo:tag, size and usage; unused images can be deleted with a y/n confirmation.
• Container lifecycle operations: stop, start, restart, pause/unpause, kill and remove (with a y/n confirmation) the selected container directly from the list. Stop, start, restart, kill and remove also apply to an entire selected stack.
• Compose view: press y to view the docker-compose file reconstructed from the Docker API, without reading the filesystem.
• Right panel subtabs: on a container the right panel cycles through logs, info, env, top, stats, vols, nets and inspect with h / l (or [ / ]); on a stack it cycles logs, info, vols and nets. enter on a stack or container jumps to the info view; esc returns to logs. info lists services, ports, volumes, networks and mounts (source -> dest); vols details every mount (type, rw/ro); nets shows each network with its ip, gateway and aliases, or the services attached per network on a stack; stats shows a live CPU/memory sample that refreshes every 2s while visible.
• Prune per tab: press P to prune the active tab's resource (stopped containers, dangling images, unused volumes or unused networks), with a y/n confirmation.
• Incremental filter: press / in any tab to filter the list by substring (case-insensitive) as you type. esc clears the filter, enter confirms it.

Aggregated logs

Exec

Install

curl -fsSL https://raw.githubusercontent.com/sonirico/duck/main/install.sh | sh

Downloads the statically linked binary for your platform (linux/darwin, amd64/arm64) from the latest release into ~/.local/bin (override with DUCK_INSTALL_DIR).

Or with Go:

go install github.com/sonirico/duck@latest

Or build from source:

git clone https://github.com/sonirico/duck.git
cd duck
just build

Keybindings

Key	Context	Action
j / k	container list	move selection
g / G	container list	jump to top / bottom
tab	anywhere	switch focus between list and logs
1 / 2 / 3 / 4	anywhere	switch tab containers/volumes/networks/images
left / right	anywhere	cycle tab containers/volumes/networks/images
e	container list	open an interactive shell in the selected container
s / S	container list	stop / start the selected container or stack
r	container list	restart the selected container or stack
p	container list	pause / unpause the selected container
K	container list	kill the selected container or stack
d	container list	remove the selected container or stack (asks y/n)
y	container list	view the reconstructed docker-compose
esc	compose view	close the compose view
[ / ] / h / l	container list	cycle the right panel's view
enter	container list	open the info view for the selected stack/container
esc	right panel	back to logs
h / l	volumes/networks/images tab	cycle the right panel's view (info/inspect)
tab	volumes/networks/images tab	switch focus to the right panel and scroll it with j / k
q	anywhere	quit
j / k	logs panel	scroll
g	logs panel	jump to top, stop following
G	logs panel	jump to bottom, resume following
d	volumes/networks/images tab	delete unused volume/network/image (asks y/n)
P	anywhere	prune the active tab's resource (asks y/n)
/	anywhere	start filtering the active tab's list
:	anywhere	command prompt: type a tab name (prefix works, e.g. :vo) and enter to jump
esc	filter	clear the filter
enter	filter	apply the filter

Development

just build      # go build
just test       # go test ./...
just check      # build, vet, test, gofmt -l
just fmt        # gofmt -w
just smoke       # ./scripts/smoke.sh
just demo-up     # start a synthetic demo stack with docker run
just demo-down   # tear it down
just record      # build, start the demo stack, re-render every vhs/*.tape, tear it down

The demo stack (scripts/demo.sh) runs a handful of Alpine/BusyBox containers with fake compose labels, so the GIFs in docs/vhs/ can be re-recorded with just record without a real application behind them.

Requirements

• A running Docker daemon.
• tmux (optional) — enables the popup/split exec integration; without it, exec falls back to an inline shell.

License

MIT