dockza.app 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Achraf El Fadili
+Copyright (c) 2026 Dmytro Shandyba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,69 @@
+dockza
+Copyright (c) 2026 Dmytro Shandyba
+
+This product includes software originally developed as "docktui"
+Copyright (c) 2026 Achraf El Fadili
+
+================================================================================
+Origin and history
+================================================================================
+
+dockza is a fork of docktui, a terminal UI for Docker originally written by
+Achraf El Fadili and released under the MIT License.
+
+  Original project : docktui
+  Original author  : Achraf El Fadili <contact@elfadiliachraf.tech>
+  Original source  : https://github.com/0xShady/docktui
+  Original license : MIT (see LICENSE)
+
+The fork was made from docktui v0.1.1. Upstream development appeared to have
+stopped, and this fork continues the work independently. It is not affiliated
+with, endorsed by, or supported by the original author or the original project.
+
+Former names of this software:
+
+  docktui   (upstream project and npm package, through v0.1.1)
+  dockza    (this fork, from v0.2.0 onward)
+
+The complete authorship record is preserved in this repository's git history,
+which retains every original commit and its author attribution unmodified.
+
+Both the original code and the modifications made in this fork are distributed
+under the MIT License. The LICENSE file carries the copyright notices of the
+original author and of the fork maintainer, as the MIT License requires.
+
+Names, logos, domains and published packages belonging to the original project
+(including the docktui name, the docktui logo, the docktui.com domain and the
+"docktui" npm package) remain the property of the original author and are not
+used by this fork. dockza carries its own name and its own logo.
+
+================================================================================
+Third-party software
+================================================================================
+
+This software depends on the following third-party packages. They are declared
+as runtime dependencies and are not bundled into this distribution; each is
+retrieved and installed by the package manager under its own license.
+
+  dayjs         MIT          https://github.com/iamkun/dayjs
+  dockerode     Apache-2.0   https://github.com/apocas/dockerode
+  neo-blessed   MIT          https://github.com/embarklabs/neo-blessed
+
+dockerode is licensed under the Apache License, Version 2.0. A copy of that
+license is available at https://www.apache.org/licenses/LICENSE-2.0. If this
+software is ever redistributed in a form that bundles or vendors dockerode's
+source or object code, the Apache-2.0 attribution requirements (Section 4)
+apply and this NOTICE must be extended accordingly.
+
+================================================================================
+Trademarks
+================================================================================
+
+Docker and the Docker logo are trademarks or registered trademarks of Docker,
+Inc. dockza is an independent, unofficial tool. It is not produced, endorsed,
+sponsored, or supported by Docker, Inc., and the "dockza" name is not a Docker,
+Inc. product name.
+
+Podman is a trademark of Red Hat, Inc. Any other product names, logos and brands
+referenced in this software or its documentation are the property of their
+respective owners and are used for identification purposes only.

package/README.md

@@ -0,0 +1,203 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/shandyba/dockza/main/assets/icon.png" alt="dockza" width="180">
+</p>
+
+<h1 align="center">dockza</h1>
+
+<p align="center">
+  A lightweight terminal UI for Docker. Manage containers, images, volumes, and networks from your terminal — Compose-aware, no mouse required.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/dockza"><img src="https://img.shields.io/npm/v/dockza.svg" alt="npm version"></a>
+  <a href="https://github.com/shandyba/dockza/actions/workflows/ci.yml"><img src="https://github.com/shandyba/dockza/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/node/v/dockza.svg" alt="Node"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+</p>
+
+<!-- TODO: record a new asciicast under the dockza name and link it here. -->
+
+## Install
+
+Run it without installing:
+
+```bash
+npx dockza
+```
+
+Or install globally:
+
+```bash
+npm install -g dockza
+dockza
+```
+
+## Features
+
+- **Compose-aware Stacks view** — containers grouped by project with running / errored / stopped counts, collapsible per stack.
+- **Containers / Images / Volumes** — live CPU and memory stats, start / stop / restart / kill / remove with confirm dialogs.
+- **Networks** — list Docker networks with driver, scope, attached-container count, creation time, and in-use status; remove unused networks (built-in networks and any with attached containers are protected).
+- **Detail panel** — full metadata, mounts, environment, live CPU/MEM bars.
+- **Streaming log viewer** with follow mode, scrollback cap, and color-coded stdout/stderr.
+- **Filter** — press `/` from Stacks to filter by stack, service, or image name.
+- **Side rail navigation** — `1`–`5` or `Tab` cycles views; click a live stack to jump to it.
+- **Help overlay** — press `h` anywhere (except confirm dialogs / the stack filter) to toggle the key-binding reference.
+- **Shell into containers** — `x` opens an external terminal `exec`'d into the selected container (macOS Terminal, Windows Terminal, common Linux emulators).
+- **Honors `DOCKER_HOST`** — works with rootless Docker, podman, and remote daemons.
+
+## Requirements
+
+- Node.js **20** or later
+- A running Docker daemon (Docker Desktop on macOS/Windows, Docker Engine on Linux, or any podman/rootless setup)
+- A **256-color** or **truecolor** terminal (`TERM=xterm-256color` or `COLORTERM=truecolor`)
+
+## Configuration
+
+### Custom Docker host
+
+dockza auto-detects the daemon socket. To point it elsewhere, set `DOCKER_HOST`:
+
+```bash
+DOCKER_HOST=unix:///run/user/1000/docker.sock dockza          # rootless docker
+DOCKER_HOST=unix:///run/user/1000/podman/podman.sock dockza   # podman
+DOCKER_HOST=tcp://10.0.0.5:2375 dockza                        # remote daemon
+DOCKER_HOST=npipe:////./pipe/docker_engine dockza             # Windows named pipe
+```
+
+### Shell-into-container (`x` key)
+
+Requires the `docker` CLI to be on your `PATH`. dockza launches your platform's native terminal with `docker exec -it <id> sh` (falls back to `bash` if available inside the container).
+
+## Key bindings
+
+### Global
+
+| Key | Action |
+|-----|--------|
+| `1` – `5` | Jump to Stacks / Containers / Images / Volumes / Networks |
+| `Tab` / `Shift+Tab` | Cycle views |
+| `h` | Toggle help overlay |
+| `q` / `Ctrl+C` | Quit |
+
+### Stacks
+
+| Key | Action |
+|-----|--------|
+| `↑ ↓` / `j k` | Navigate tree |
+| `→` / `←` | Expand / collapse stack |
+| `Enter` | On a stack: toggle expand. On a service: open detail panel |
+| `/` | Open filter (`Esc` to clear) |
+| `l` | Open log viewer |
+| `x` | Shell into selected running container |
+| `s` / `r` / `k` | Stop / restart / kill running container (confirm) |
+| `S` | Start stopped container |
+| `d` | Remove stopped container (confirm) |
+
+### Containers
+
+Same per-container actions as Stacks. `Enter` always opens the detail panel.
+
+### Detail panel
+
+Same container actions as the list/tree (`l`, `s`, `r`, `k`, `S`, `d`, `x`) plus:
+
+| Key | Action |
+|-----|--------|
+| `e` | Toggle environment variables (expanded / collapsed) |
+| `↑ ↓` | Scroll |
+| `Esc` | Close |
+
+### Log viewer
+
+| Key | Action |
+|-----|--------|
+| `f` | Toggle follow mode |
+| `g` | Scroll to top |
+| `G` | Scroll to bottom, re-enable follow |
+| `↑` / `k` | Scroll up (disables follow) |
+| `Esc` | Close |
+
+### Images, Volumes & Networks
+
+| Key | Action |
+|-----|--------|
+| `↑ ↓` / `j k` | Navigate list |
+| `d` | Delete unused item (confirm) |
+
+Networks additionally protect the built-in `bridge` / `host` / `none` networks and any network with attached containers — `d` on those shows a message instead of a confirm dialog. In-use detection is consistent with Images and Volumes: a network counts as in use whenever a container is attached, running or stopped.
+
+### Confirm dialog
+
+| `y` / `Y` to confirm · `n` / `N` / `Esc` to cancel |
+|-----------------------------------------------------|
+
+## Troubleshooting
+
+### `permission denied` on the Docker socket (Linux)
+
+Add your user to the `docker` group, then log out and back in:
+
+```bash
+sudo usermod -aG docker $USER
+```
+
+### Windows: cannot connect to the daemon
+
+By default dockza tries the named pipe `//./pipe/docker_engine`. If that fails, enable TCP in Docker Desktop (**Settings → General → Expose daemon on `tcp://localhost:2375` without TLS**) and run:
+
+```bash
+DOCKER_HOST=tcp://localhost:2375 dockza
+```
+
+### `dockza requires a 256-color (or truecolor) terminal`
+
+Your `$TERM` is too narrow. Set it explicitly or use a modern terminal:
+
+```bash
+TERM=xterm-256color dockza
+```
+
+### `The 'docker' CLI is not on your PATH`
+
+You hit `x` (shell into container) but the `docker` binary isn't installed or isn't on `PATH`. Install Docker CLI or skip the `x` action — everything else works without it.
+
+## Development
+
+```bash
+git clone https://github.com/shandyba/dockza.git
+cd dockza
+npm install
+
+npm run dev            # run from source with ts-node
+npm run build          # compile to dist/
+npm start              # run compiled output
+
+npm test               # vitest, one-shot
+npm run test:coverage  # generate ./coverage/index.html
+npm run lint
+npm run format
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the pre-PR checklist and [CHANGELOG.md](./CHANGELOG.md) for release history.
+
+## Credits
+
+dockza is a fork of [**docktui**](https://github.com/0xShady/docktui) by
+[Achraf El Fadili](https://github.com/0xShady), released under the MIT License.
+Upstream development appeared to have stopped, so this fork continues the work
+independently under a new name. Every original commit and its authorship is
+preserved in this repository's git history.
+
+This project is not affiliated with, endorsed by, or supported by the original
+author or the original project. Bug reports and feature requests belong
+[here](https://github.com/shandyba/dockza/issues), not upstream.
+
+Docker and the Docker logo are trademarks or registered trademarks of Docker,
+Inc. dockza is an independent, unofficial tool and is not a Docker, Inc.
+product.
+
+## License
+
+[MIT](./LICENSE) © Achraf El Fadili (original work) · © Dmytro Shandyba (fork and subsequent work)
+
+See [NOTICE](./NOTICE) for attribution details and third-party licenses.

package/dist/cli.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("./docker/client");
+const app_1 = require("./ui/app");
+const term_caps_1 = require("./utils/term-caps");
+async function main() {
+    const colors = (0, term_caps_1.detectColors)();
+    if (colors === 'low') {
+        process.stderr.write('dockza requires a 256-color (or truecolor) terminal. Set TERM=xterm-256color or use a modern terminal emulator.\n');
+        process.exit(1);
+    }
+    try {
+        await (0, client_1.pingDocker)();
+    }
+    catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    try {
+        const app = new app_1.App();
+        await app.start();
+        process.exit(0);
+    }
+    catch (err) {
+        process.stderr.write(`Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/docker/client.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerode = void 0;
+exports.getDockerSocketLabel = getDockerSocketLabel;
+exports.pingDocker = pingDocker;
+exports.getDockerVersion = getDockerVersion;
+const fs_1 = require("fs");
+const dockerode_1 = __importDefault(require("dockerode"));
+let socketLabel = '';
+function createDockerode() {
+    // Honor DOCKER_HOST when set (rootless docker, podman, remote daemons).
+    // Supported forms: unix:///path/to/sock, npipe:////./pipe/name, tcp://host:port
+    const host = process.env.DOCKER_HOST;
+    if (host) {
+        if (host.startsWith('unix://')) {
+            const sock = host.slice('unix://'.length);
+            socketLabel = `unix://${sock}`;
+            return new dockerode_1.default({ socketPath: sock });
+        }
+        if (host.startsWith('npipe://')) {
+            const sock = host.slice('npipe://'.length);
+            socketLabel = `npipe://${sock}`;
+            return new dockerode_1.default({ socketPath: sock });
+        }
+        if (host.startsWith('tcp://') || host.startsWith('http://') || host.startsWith('https://')) {
+            const url = new URL(host);
+            socketLabel = host;
+            return new dockerode_1.default({
+                host: url.hostname,
+                port: Number(url.port) || (url.protocol === 'https:' ? 2376 : 2375),
+                protocol: url.protocol === 'https:' ? 'https' : 'http',
+            });
+        }
+        throw new Error(`Unrecognized DOCKER_HOST scheme: '${host}'. Expected unix://…, npipe://…, tcp://…, http://…, or https://…`);
+    }
+    if (process.platform === 'win32') {
+        socketLabel = 'npipe:////./pipe/docker_engine';
+        return new dockerode_1.default({ socketPath: '//./pipe/docker_engine' });
+    }
+    // macOS Docker Desktop sometimes only exposes the per-user socket; prefer it when present.
+    const userSock = `${process.env.HOME ?? ''}/.docker/run/docker.sock`;
+    if (process.platform === 'darwin' && process.env.HOME && (0, fs_1.existsSync)(userSock)) {
+        socketLabel = `unix://${userSock}`;
+        return new dockerode_1.default({ socketPath: userSock });
+    }
+    socketLabel = 'unix:///var/run/docker.sock';
+    return new dockerode_1.default({ socketPath: '/var/run/docker.sock' });
+}
+exports.dockerode = createDockerode();
+function getDockerSocketLabel() {
+    return socketLabel;
+}
+async function pingDocker() {
+    try {
+        await exports.dockerode.ping();
+    }
+    catch (err) {
+        const raw = err instanceof Error ? err.message : String(err);
+        if (/EACCES|permission denied/i.test(raw) && process.platform === 'linux') {
+            throw new Error(`Cannot access the Docker socket (permission denied). Add your user to the 'docker' group: sudo usermod -aG docker $USER (then log out and back in). (${raw})`);
+        }
+        throw new Error(`Docker is not running or not accessible. Make sure the Docker daemon is started. (${raw})`);
+    }
+}
+async function getDockerVersion() {
+    try {
+        const info = (await exports.dockerode.version());
+        return String(info?.Version ?? '');
+    }
+    catch {
+        return 'unknown';
+    }
+}

package/dist/docker/containers.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toContainerInfo = toContainerInfo;
+exports.listContainers = listContainers;
+exports.toContainerStats = toContainerStats;
+exports.fetchStats = fetchStats;
+exports.startContainer = startContainer;
+exports.stopContainer = stopContainer;
+exports.restartContainer = restartContainer;
+exports.killContainer = killContainer;
+exports.removeContainer = removeContainer;
+exports.streamLogs = streamLogs;
+const client_1 = require("./client");
+const format_1 = require("../utils/format");
+const stats_1 = require("../utils/stats");
+const VALID_STATUSES = new Set([
+    'running',
+    'paused',
+    'exited',
+    'restarting',
+    'dead',
+    'created',
+    'removing',
+]);
+function toContainerInfo(raw, inspected) {
+    const name = (raw.Names?.[0] ?? raw.Id).replace(/^\//, '');
+    const status = VALID_STATUSES.has(raw.State)
+        ? raw.State
+        : 'exited';
+    let uptime = raw.Status;
+    if (inspected) {
+        if (status === 'running' || status === 'paused' || status === 'restarting') {
+            const startedAt = new Date(inspected.State.StartedAt);
+            if (startedAt.getTime() > 0)
+                uptime = (0, format_1.humanUptime)(startedAt);
+        }
+        else if (status === 'exited' || status === 'dead') {
+            const finishedAt = new Date(inspected.State.FinishedAt);
+            if (finishedAt.getTime() > 0)
+                uptime = (0, format_1.relativeTime)(finishedAt);
+        }
+    }
+    // The daemon sends null (not []) for these when a container publishes no ports
+    // or is attached to no networks, so every access here has to tolerate null.
+    const ports = (raw.Ports ?? []).map((p) => p.PublicPort
+        ? `${p.IP ? `${p.IP}:` : ''}${p.PublicPort}->${p.PrivatePort}/${p.Type}`
+        : `${p.PrivatePort}/${p.Type}`);
+    const rawNetworks = raw.NetworkSettings?.Networks ?? {};
+    const networks = Object.keys(rawNetworks);
+    const ip = networks.length > 0 ? (rawNetworks[networks[0]]?.IPAddress ?? '') : '';
+    const mounts = (raw.Mounts ?? []).map((m) => ({
+        source: m.Source ?? '',
+        destination: m.Destination ?? '',
+        mode: m.Mode ?? '',
+        rw: m.RW ?? false,
+        type: m.Type ?? 'bind',
+    }));
+    return {
+        id: raw.Id,
+        name,
+        image: raw.Image,
+        status,
+        exitCode: inspected?.State?.ExitCode ?? 0,
+        uptime,
+        ports,
+        networks,
+        ip,
+        mounts,
+        env: inspected?.Config?.Env ?? [],
+        restartPolicy: inspected?.HostConfig?.RestartPolicy?.Name ?? 'no',
+        pids: inspected?.State?.Pid ?? 0,
+        labels: raw.Labels ?? {},
+    };
+}
+async function listContainers() {
+    try {
+        const rawList = await client_1.dockerode.listContainers({ all: true });
+        return await Promise.all(rawList.map(async (raw) => {
+            let inspected = null;
+            try {
+                inspected = await client_1.dockerode.getContainer(raw.Id).inspect();
+            }
+            catch {
+                // Fall back to list data if inspect fails
+            }
+            return toContainerInfo(raw, inspected);
+        }));
+    }
+    catch (err) {
+        throw new Error(`Failed to list containers: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function toContainerStats(stats) {
+    const usage = stats.memory_stats.usage;
+    const limit = stats.memory_stats.limit;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const blkio = stats.blkio_stats?.io_service_bytes_recursive ?? [];
+    const readBytes = blkio
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .filter((b) => b.op === 'Read' || b.op === 'read')
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .reduce((sum, b) => sum + (b.value ?? 0), 0);
+    const writeBytes = blkio
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .filter((b) => b.op === 'Write' || b.op === 'write')
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .reduce((sum, b) => sum + (b.value ?? 0), 0);
+    return {
+        cpuPercent: (0, stats_1.calcCPUPercent)(stats),
+        memUsageMB: usage / 1024 / 1024,
+        memLimitMB: limit / 1024 / 1024,
+        memPercent: limit > 0 ? (usage / limit) * 100 : 0,
+        diskReadMB: readBytes / 1024 / 1024,
+        diskWriteMB: writeBytes / 1024 / 1024,
+    };
+}
+async function fetchStats(id) {
+    try {
+        const stats = await client_1.dockerode.getContainer(id).stats({ stream: false });
+        return toContainerStats(stats);
+    }
+    catch (err) {
+        throw new Error(`Failed to fetch stats for container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function startContainer(id) {
+    try {
+        await client_1.dockerode.getContainer(id).start();
+    }
+    catch (err) {
+        throw new Error(`Failed to start container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function stopContainer(id) {
+    try {
+        await client_1.dockerode.getContainer(id).stop();
+    }
+    catch (err) {
+        throw new Error(`Failed to stop container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function restartContainer(id) {
+    try {
+        await client_1.dockerode.getContainer(id).restart();
+    }
+    catch (err) {
+        throw new Error(`Failed to restart container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function killContainer(id) {
+    try {
+        await client_1.dockerode.getContainer(id).kill();
+    }
+    catch (err) {
+        throw new Error(`Failed to kill container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function removeContainer(id) {
+    try {
+        await client_1.dockerode.getContainer(id).remove({ force: true });
+    }
+    catch (err) {
+        throw new Error(`Failed to remove container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function streamLogs(id, tail) {
+    try {
+        return await client_1.dockerode.getContainer(id).logs({
+            follow: true,
+            stdout: true,
+            stderr: true,
+            tail,
+            timestamps: false,
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to stream logs for container ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}

package/dist/docker/images.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listImages = listImages;
+exports.removeImage = removeImage;
+const client_1 = require("./client");
+async function listImages() {
+    try {
+        const [rawImages, rawContainers] = await Promise.all([
+            client_1.dockerode.listImages({ all: false }),
+            client_1.dockerode.listContainers({ all: true }),
+        ]);
+        const usedImageIds = new Set(rawContainers.map((c) => c.ImageID));
+        return rawImages
+            .sort((a, b) => (a.RepoTags?.[0] ?? '').localeCompare(b.RepoTags?.[0] ?? ''))
+            .map((img) => {
+            const repoTag = img.RepoTags?.[0] ?? '<none>:<none>';
+            const colonIdx = repoTag.lastIndexOf(':');
+            const repository = colonIdx >= 0 ? repoTag.slice(0, colonIdx) || '<none>' : '<none>';
+            const tag = colonIdx >= 0 ? repoTag.slice(colonIdx + 1) || '<none>' : '<none>';
+            return {
+                id: img.Id,
+                repository,
+                tag,
+                sizeMB: img.Size / 1024 / 1024,
+                created: new Date(img.Created * 1000),
+                inUse: usedImageIds.has(img.Id),
+            };
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to list images: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function removeImage(id) {
+    try {
+        await client_1.dockerode.getImage(id).remove();
+    }
+    catch (err) {
+        throw new Error(`Failed to remove image ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}