Sidekick Docker for VS Code

A Docker management dashboard embedded directly in VS Code, VSCodium, and compatible editors. Manage containers, Compose projects, images, volumes, and networks without leaving your editor.

Install

From VSIX

cd sidekick-docker-vscode
npm install
npm run build
code --install-extension sidekick-docker-vscode-0.1.0.vsix

Build from Source

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

Then open the sidekick-docker-vscode folder in VSCode and press F5 to launch the Extension Development Host.

Usage

Open the command palette (Ctrl+Shift+P / Cmd+Shift+P) and run:

Sidekick Docker: Open Dashboard

The dashboard opens as a webview panel with the same layout and capabilities as the terminal TUI.

Features

• Full Docker dashboard in VSCode — containers, Compose, images, volumes, networks
• Real-time updates — logs and stats stream live inside the editor
• Container management — start, stop, restart, remove containers directly
• Compose support — detect and manage Compose projects
• Log streaming — view stdout/stderr with color coding
• Stats monitoring — live CPU and memory metrics

Requirements

• VSCode >= 1.85
• Docker running and accessible
• Node.js >= 20 (for building from source)

Architecture

The extension uses a webview panel to render the dashboard UI. The extension host (Node.js) communicates with the webview (browser) via postMessage() with a typed message protocol:

• Extension side (src/extension.ts) — activates on command, creates the DockerDashboardProvider
• Provider (src/providers/DockerDashboardProvider.ts) — manages the webview lifecycle, handles Docker API calls via sidekick-docker-shared
• Webview (out/webview/dashboard.js) — renders the dashboard UI, sends user actions back to the extension
• Message types (src/types/messages.ts) — typed request/response messages between extension and webview

Documentation

Full documentation is available at the docs site.

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 a VS Code extension.

Contributing

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

License

MIT