dockscope #

dockscope is a TUI for viewing Docker containers, logs, metrics and other info, inspired by lazydocker and dtop. I wanted something similar, a no config TUI, but also with easy search/tracing across containers to help debug things at work. In this new age of AI agents, I can build the exact tool I need. And here it is.

Recipes #

This project uses just for project-specific commands.

Run just to see available recipes

Install #

To install:

just install

To run:

ds

Usage #

dockscope is a single-binary TUI with four modes:

• Live mode (default): The container list. Displays all running containers with ID, name, state, image, and brief status. Multiple containers can be selected for log streaming.
• Log mode: Streams logs from one or more selected containers into a scrollable ring buffer. Trace IDs in log lines are highlighted and clickable.
• Trace mode: Enter a trace ID to see all matching log lines across all containers. Once results are shown, use n/p to cycle through found trace IDs, y to copy the active trace ID, and s to jump to search mode prefilled with the active trace ID.
• Search mode: Full-text, case-insensitive search across all container logs. Keeps streaming in the background and shows matches in real time.

Use ? to see the help menu.

Development #

To run the app in dev mode:

just up