Docker Runner

Manage Docker containers and images directly from VS Code — side by side with your code.

Features

📦 Image Browser

• Browse local images in a sidebar tree or a full table view
• Inspect image details (history, config, environment)
• Pull, push, save, and delete images
• Generate Dockerfiles from existing images — reconstruct a Dockerfile from an image's history and inspect data

🚢 Container Manager

• List all containers (running + stopped) in tree or table view
• Start, stop, restart, pause, and unpause containers
• Detail view with tabs: Summary, Inspect (raw JSON), Ports, Environment, Mounts, History
• History tab shows:
  • Recent logs (docker logs --tail 50)
  • Filesystem changes (docker diff)
  • Shell command history from inside the container
• Attach terminal, execute commands, commit changes to new images
• Create Dockerfile from Changes — snapshots a container, extracts its configuration, and generates a Dockerfile

📁 Container Filesystem Explorer

• Browse a container's filesystem with a familiar directory-tree UI
• Navigate with breadcrumbs, Back/Home buttons
• Click directories to drill down, double-click files to view content
• Filter files with the built-in search bar

🔍 Docker Hub Search

• Search Docker Hub from within VS Code
• Results displayed in a managed table (Name, Description, Stars, Official badge)
• Pull individual images or batch-pull selected/all results
• Supports multi-select with checkbox column

🔧 Flexible Execution Model

Configure how Docker commands are executed via Docker Runner: Terminal (Command Palette):

No command runs without your knowledge — choose the level of visibility you're comfortable with.

Getting Started

1. Install Docker — you need the Docker CLI (docker) available on your system PATH.
2. Click the Docker icon in the VS Code activity bar to open the Docker Explorer.
3. Browse images and containers, or use the Command Palette (Ctrl+Shift+P) to run specific commands.

Quick Reference

Extension Map

Everything in Docker Runner is organized around a sidebar tree view and several webview panels. The same commands are surfaced through multiple entry points (tree, menus, palette, table views, detail panels).

🧭 Views

🌳 Tree Item Types (contextValue)

Each item in the tree has a contextValue that controls which inline ... menu is shown:

⌨️ All Commands

🔗 Entry Point Matrix

How different actions connect across the UI:

Activity Bar ──dockerRunnerExplorer──────┐
   │  (Tree View)                        │
   ├── Refresh (↻ button)                │
   ├── Click Docker → (root)             │
   ├── Click Images ───→ Images Table    │
   ├── Click Containers → Containers Tab.│
   ├── Item `...` ───→ QuickPick Menu ───┤
   │      ├── docker-image: View, Create, Dockerfile, Pull, Push, Save, Delete
   │      ├── docker-container: View, Start|Stop|Restart|Pause|Unpause,
   │      │     AttachTerminal, BrowseFs, Dockerfile, Export, Delete
   │      ├── docker-image-list: Search, Load, Import, Prune
   │      └── docker-container-list: Prune
   └── Click item ──→ Detail Webview ────┤
         (Images/Containers)              │
         ├── Tabs: Summary, Inspect,     │
         │   Ports, Env, Mounts, History │
         └── Toolbar `···` ──→ same      │
              actions as tree             │

Images Table ──→ row click QuickPick ──→ ViewDetails, CreateContainer,
                  Dockerfile, Pull, Push, Save, Delete, Prune
Containers Table → row click QuickPick ──→ ViewDetails, AttachTerm,
                  Start/Stop/Restart/Pause/Unpause, BrowseFs,
                  Dockerfile, Export, Delete, Prune
Hub Search ──→ toolbar search ──→ multi-select pull
Filesystem  ──→ toolbar (Back, Home, Reload) ──→ click dir = navigate,
                  click file = open in editor
Detail Panel ──→ toolbar `···` ──→ same actions as tree context menu
                   per item type


- **Docker** installed and accessible from the command line
- VS Code 1.85+

## Extension Settings

This extension contributes the following setting:

* `docker-runner.executionMode`: Controls which Docker commands execute in a visible VS Code terminal (`none`, `some`, or `all`).

## Privacy & Transparency

Docker Runner executes the same Docker CLI commands you would run manually. It never obscures what it does — every pull, push, start, stop, or delete operation can be observed in the integrated terminal when terminal mode is enabled.

The extension does **not** collect telemetry, send data to external servers (other than Docker Hub when you search or pull), or require any account or login.

## Development

```bash
cd vscode-extensions/docker-runner
npm install
npm run compile       # dev build
npm run package       # production build (minified)
npx @vscode/vsce package   # create .vsix

License

LICENSE