Skip to content

Repository files navigation

Sidekick Docker

Sidekick Docker

Open VSX Open VSX Downloads VS Code Marketplace VS Code Installs npm npm Downloads License: MIT CI Ask DeepWiki

Your Docker dashboard, everywhere. A full-featured Docker management dashboard that runs in your terminal and in VS Code.

Sidekick Docker TUI Demo

Sidekick Docker VS Code Extension Demo

What is this?

Sidekick Docker gives you a real-time, keyboard-driven dashboard for managing your entire Docker environment — containers, Compose projects, images, volumes, and networks. Run it as a standalone TUI in any terminal, or open it as a panel inside VS Code. Same power, two surfaces.

Features

  • Real-time streaming — logs, stats, and Docker events update live as they happen
  • Smart log highlighting — token-level syntax coloring for HTTP methods, status codes, URLs, IPs, timestamps, JSON keys, and more
  • Log search & filter — search within log output with exact or fuzzy matching and match highlighting
  • Log analytics — severity counts, severity sparkline over time, and pattern clustering that groups similar logs into templates
  • Dual-log compare — pin a second container or service to compare log streams side by side
  • Vi keybindings — navigate with j/k, jump with g/G, switch panels with 1-5, page with PgUp/PgDn or Ctrl+D/Ctrl+U
  • Sparkline charts — CPU, memory, network I/O, block I/O, and log severity rendered as inline sparklines
  • Filesystem inspector — view all filesystem changes inside containers (added/changed/deleted files)
  • Image layer explorer — inspect image layer history with sizes and Dockerfile instructions
  • Compose support — detect projects from container labels, run up/down/restart per project
  • Interactive exec — drop into a running container shell without leaving the dashboard
  • Filter & search/ to filter any resource list by name
  • Confirmation modals — destructive actions (remove, prune) always ask first
  • Mouse support — click to select, scroll to navigate, right-click for the actions menu
  • Scriptable CLIps, logs, images, volumes, networks, stats, df and inspect, each with --format json and -q where it makes sense, for scripts and pipes, with --no-color/NO_COLOR support
  • Disk usagedf reports images, containers, volumes and build cache, the last of which is usually the biggest surprise
  • Prune everything — reclaim space from stopped containers, dangling images, unused volumes and networks, with the reclaimed total reported back
  • Flexible endpoints--socket accepts a socket path, unix:// URL, or tcp://host:port for remote daemons
  • VS Code extension — the same dashboard, embedded as a webview panel

Quick Start

Terminal (TUI)

npm install -g sidekick-docker
sidekick-docker

VS Code / VSCodium / Compatible Editors

Install the Sidekick Docker extension from Open VSX or the VS Code Marketplace, then run Sidekick Docker: Open Dashboard from the command palette (or press Ctrl+Alt+D).

Packages

Package Description
sidekick-docker-cli TUI dashboard and CLI commands (Ink + React)
sidekick-docker-shared Docker API abstraction layer, types, Compose detection
sidekick-docker-vscode VS Code extension with embedded dashboard webview

Build from Source

git clone https://github.com/cesarandreslopez/sidekick-docker.git
cd sidekick-docker
bash scripts/build-all.sh
node ./sidekick-docker-cli/dist/sidekick-docker.mjs

Requires Node.js >= 22.12 and Docker running.

Documentation

Full documentation is available at the docs site, including:

See Also

Sidekick Agent Hub — Multi-provider AI coding agent monitor. Real-time visibility into Claude Code, OpenCode, and Codex CLI sessions with token tracking, context management, and session intelligence. Available as a TUI on npm and as a VS Code extension on the Marketplace and Open VSX.

Contributing

Contributions are welcome! See CONTRIBUTING.md for setup instructions and guidelines.

License

MIT

About

The best TUI and VSCode extension for managing Docker containers and Compose. Period.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

9 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages