cdd-cli 4.0.0 → 4.1.0

package/README.es.md

@@ -6,9 +6,6 @@
   <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
     <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
   </a>
-  <a href="https://caertos.github.io/cdd/">
-    <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
-  </a>
   <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
@@ -16,9 +13,21 @@
 
 ---
 
-## 🎉 Novedades en v3.2
+## 🎉 Novedades en v4.1
+
+**Abrí un shell dentro de cualquier contenedor con una sola tecla.**
+
+Presiona `S` y CDD te lleva a un shell interactivo completo (`bash` o `sh`) dentro del contenedor seleccionado — sin necesidad de escribir `docker exec`.
+
+- **Shell auto-detectado** — CDD sondea el contenedor y elige `bash` o `sh` automáticamente
+- **Soporte de terminal completo** — ejecutá `psql`, `python3`, `node`, `redis-cli`, o cualquier comando dentro del contenedor
+- **Salida limpia** — escribí `exit` o presioná `Ctrl+D` para volver al dashboard
+
+---
+
+## Versiones anteriores
 
-**v3.2 trae el asistente de creación interactivo — y cambia las reglas del juego.**
+### v3.2 — Asistente de creación interactivo
 
 Olvídate de los flags de `docker run`, las variables de entorno olvidadas y los tags `:latest` que fallan en silencio. Presiona `C` y CDD te guía para crear un contenedor en segundos:
 
@@ -84,6 +93,7 @@ Usa `↑` / `↓` para navegar por los contenedores. Atajos de teclado disponibl
 | `R` | Reiniciar el contenedor seleccionado |
 | `C` | Abrir el asistente de creación |
 | `L` | Ver logs del contenedor seleccionado en tiempo real |
+| `S` | Abrir shell interactivo dentro del contenedor seleccionado |
 | `E` | Eliminar el contenedor seleccionado — requiere confirmación |
 | `D` | Activar/desactivar panel de debug en vivo |
 | `Q` | Salir |
@@ -126,6 +136,20 @@ Presiona `Enter` en una línea vacía para terminar y crear el contenedor.
 
 ---
 
+## Shell Interactivo
+
+Presiona `S` desde el dashboard con un contenedor en ejecución seleccionado. CDD hará lo siguiente:
+
+1. Detectará el shell disponible dentro del contenedor (`bash` o `sh`)
+2. Abrirá una sesión de terminal interactiva completa
+3. Te dejará en el shell del contenedor
+
+Desde ahí podés ejecutar cualquier comando — `psql` para PostgreSQL, `python3` para Python, `node` para Node.js, `redis-cli` para Redis, etc.
+
+Escribí `exit` o presioná `Ctrl+D` para salir del shell y volver al dashboard de CDD.
+
+---
+
 ## Requisitos
 
 - Node.js >= 18

package/README.md

@@ -6,9 +6,6 @@
   <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
     <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
   </a>
-  <a href="https://caertos.github.io/cdd/">
-    <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
-  </a>
   <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
@@ -16,9 +13,21 @@
 
 ---
 
-## 🎉 What's new in v3.2
+## 🎉 What's new in v4.1
+
+**Open a shell inside any container with a single keystroke.**
+
+Press `S` and CDD drops you into a full interactive shell (`bash` or `sh`) inside the selected container — no `docker exec` typing needed.
+
+- **Auto-detected shell** — CDD probes the container and picks `bash` or `sh` automatically
+- **Full terminal support** — run `psql`, `python3`, `node`, `redis-cli`, or any command inside the container
+- **Clean exit** — type `exit` or press `Ctrl+D` to return to the dashboard
+
+---
+
+## Previous releases
 
-**v3.2 ships the interactive creation wizard — and it's a game changer.**
+### v3.2 — Interactive creation wizard
 
 Forget `docker run` flags, forgotten env vars, and broken `:latest` tags. Press `C` and CDD guides you through creating a container in seconds:
 
@@ -84,6 +93,7 @@ Use `↑` / `↓` to navigate containers. Available keyboard shortcuts:
 | `R` | Restart selected container |
 | `C` | Open creation wizard |
 | `L` | Stream logs for selected container |
+| `S` | Open interactive shell inside selected container |
 | `E` | Erase (remove) selected container — confirmation required |
 | `D` | Toggle live debug panel |
 | `Q` | Quit |
@@ -126,6 +136,20 @@ Press `Enter` on an empty line to finish and create the container.
 
 ---
 
+## Interactive Shell
+
+Press `S` from the dashboard while a running container is selected. CDD will:
+
+1. Detect the available shell inside the container (`bash` or `sh`)
+2. Open a full interactive terminal session
+3. Drop you into the container's shell
+
+From there you can run any command — `psql` for PostgreSQL, `python3` for Python, `node` for Node.js, `redis-cli` for Redis, etc.
+
+Type `exit` or press `Ctrl+D` to leave the shell and return to the CDD dashboard.
+
+---
+
 ## Requirements
 
 - Node.js >= 18

package/dist/components/UsageMenu.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { Box, Text } from 'ink';
-var SHORTCUTS = ['Use ↑/↓ for navigation', 'I to initiate selected container', 'P to stop selected container', 'R to restart selected container', 'C to create a container', 'L to view logs of selected container', 'D to toggle debug log panel', 'E to remove selected container', 'Q to quit'];
+var SHORTCUTS = ['Use ↑/↓ for navigation', 'I to initiate selected container', 'P to stop selected container', 'R to restart selected container', 'C to create a container', 'L to view logs of selected container', 'S to open shell in selected container', 'D to toggle debug log panel', 'E to remove selected container', 'Q to quit'];
 var GRID_COLUMNS = 3;
 
 /**

package/dist/helpers/appState.js

@@ -0,0 +1,26 @@
+/**
+ * Shared reference to the Ink render instance.
+ * Set once in index.js after render(<App />) and read by useShellMode
+ * to unmount/remount the UI around interactive shell sessions.
+ *
+ * @module appState
+ */
+
+/** @type {import('ink').RenderReturnType | null} */
+var inkApp = null;
+
+/**
+ * Store the Ink render return value.
+ * @param {import('ink').RenderReturnType} app
+ */
+export function setInkApp(app) {
+  inkApp = app;
+}
+
+/**
+ * Get the Ink render return value.
+ * @returns {import('ink').RenderReturnType | null}
+ */
+export function getInkApp() {
+  return inkApp;
+}

package/dist/helpers/dockerService/serviceComponents/containerExec.js

@@ -0,0 +1,211 @@
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+import { spawn } from 'child_process';
+import { docker } from '../dockerService.js';
+import { logger } from '../../logger.js';
+import { TIMEOUTS } from '../../constants.js';
+
+/**
+ * Detect the default shell available inside a running container.
+ * Tries `bash` first, falls back to `sh`.
+ *
+ * @param {string} containerId - Docker container id
+ * @returns {Promise<string>} The shell command (e.g. 'bash' or 'sh')
+ */
+export function detectShell(_x) {
+  return _detectShell.apply(this, arguments);
+}
+
+/**
+ * Spawn an interactive shell inside a running container using `docker exec -it`.
+ * Returns a promise that resolves when the user exits the shell.
+ *
+ * @param {string} containerId - Docker container id
+ * @param {Object} [options]
+ * @param {string} [options.shell] - Shell to use (auto-detected if omitted)
+ * @param {string} [options.workingDir] - Working directory inside the container
+ * @returns {Promise<{code: number|null, signal: string|null}>} Exit info
+ */
+function _detectShell() {
+  _detectShell = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(containerId) {
+    var container, tryShell, hasBash, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          container = docker.getContainer(containerId);
+          tryShell = function tryShell(shell) {
+            return new Promise(function (resolve) {
+              container.exec({
+                Cmd: ['which', shell],
+                AttachStdout: true,
+                AttachStderr: false,
+                Tty: false
+              }, function (err, exec) {
+                if (err) {
+                  resolve(false);
+                  return;
+                }
+                exec.start({
+                  Tty: false
+                }, function (startErr, stream) {
+                  if (startErr) {
+                    resolve(false);
+                    return;
+                  }
+                  var output = '';
+                  stream.on('data', function (chunk) {
+                    output += chunk.toString();
+                  });
+                  stream.on('end', function () {
+                    resolve(output.trim().length > 0);
+                  });
+                  stream.on('error', function () {
+                    return resolve(false);
+                  });
+                });
+              });
+            });
+          };
+          _context.p = 1;
+          _context.n = 2;
+          return Promise.race([tryShell('bash'), new Promise(function (r) {
+            return setTimeout(function () {
+              return r(false);
+            }, TIMEOUTS.CONTAINER_OP);
+          })]);
+        case 2:
+          hasBash = _context.v;
+          if (!hasBash) {
+            _context.n = 3;
+            break;
+          }
+          logger.debug('Detected bash in container %s', containerId);
+          return _context.a(2, 'bash');
+        case 3:
+          _context.n = 5;
+          break;
+        case 4:
+          _context.p = 4;
+          _t = _context.v;
+        case 5:
+          logger.debug('Falling back to sh in container %s', containerId);
+          return _context.a(2, 'sh');
+      }
+    }, _callee, null, [[1, 4]]);
+  }));
+  return _detectShell.apply(this, arguments);
+}
+export function execInteractive(_x2) {
+  return _execInteractive.apply(this, arguments);
+}
+
+/**
+ * Execute a non-interactive command inside a running container.
+ * Returns stdout and stderr as strings.
+ *
+ * @param {string} containerId - Docker container id
+ * @param {string[]} cmd - Command to execute (e.g. ['ls', '-la'])
+ * @param {Object} [options]
+ * @param {number} [options.timeout] - Timeout in ms
+ * @returns {Promise<{stdout: string, stderr: string, exitCode: number}>}
+ */
+function _execInteractive() {
+  _execInteractive = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(containerId) {
+    var options,
+      shell,
+      args,
+      _args2 = arguments,
+      _t2;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
+          _t2 = options.shell;
+          if (_t2) {
+            _context2.n = 2;
+            break;
+          }
+          _context2.n = 1;
+          return detectShell(containerId);
+        case 1:
+          _t2 = _context2.v;
+        case 2:
+          shell = _t2;
+          args = ['exec', '-it', containerId, shell];
+          if (options.workingDir) {
+            args.splice(3, 0, '-w', options.workingDir);
+          }
+          logger.info('Opening interactive shell in container %s (shell=%s)', containerId, shell);
+          return _context2.a(2, new Promise(function (resolve, reject) {
+            var child = spawn('docker', args, {
+              stdio: 'inherit',
+              shell: false
+            });
+            child.on('error', function (err) {
+              logger.error('Failed to spawn docker exec', err);
+              reject(new Error("Failed to open shell: ".concat(err.message)));
+            });
+            child.on('close', function (code, signal) {
+              logger.info('Interactive shell exited (code=%s, signal=%s)', code, signal);
+              resolve({
+                code: code,
+                signal: signal
+              });
+            });
+          }));
+      }
+    }, _callee2);
+  }));
+  return _execInteractive.apply(this, arguments);
+}
+export function execCommand(containerId, cmd) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  return new Promise(function (resolve, reject) {
+    var container = docker.getContainer(containerId);
+    container.exec({
+      Cmd: cmd,
+      AttachStdout: true,
+      AttachStderr: true,
+      Tty: false
+    }, function (err, exec) {
+      if (err) {
+        return reject(new Error("Exec create failed: ".concat(err.message)));
+      }
+      exec.start({
+        Tty: false
+      }, function (startErr, stream) {
+        if (startErr) {
+          return reject(new Error("Exec start failed: ".concat(startErr.message)));
+        }
+        var stdout = '';
+        var stderr = '';
+        stream.on('data', function (chunk) {
+          var str = chunk.toString();
+          // Docker multiplexed streams use 8-byte headers.
+          // For Tty=false, output is multiplexed; for simplicity we accumulate.
+          stdout += str;
+        });
+        stream.on('end', function () {
+          exec.inspect(function (inspectErr, info) {
+            var _info$ExitCode;
+            resolve({
+              stdout: stdout.trim(),
+              stderr: stderr.trim(),
+              exitCode: (_info$ExitCode = info === null || info === void 0 ? void 0 : info.ExitCode) !== null && _info$ExitCode !== void 0 ? _info$ExitCode : -1
+            });
+          });
+        });
+        stream.on('error', function (streamErr) {
+          reject(new Error("Stream error: ".concat(streamErr.message)));
+        });
+        if (options.timeout) {
+          setTimeout(function () {
+            reject(new Error('Command timed out'));
+          }, options.timeout);
+        }
+      });
+    });
+  });
+}

package/dist/hooks/creation/useContainerCreation.js

@@ -200,6 +200,25 @@ export function useContainerCreation(_ref) {
 
   // Timer for auto-clearing messages
   var messageTimerRef = useRef(null);
+
+  /**
+   * Sets a permanent message (e.g. step instructions). No auto-clear.
+   */
+  function setStepMessage(msg) {
+    var color = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'yellow';
+    clearTimeout(messageTimerRef.current);
+    dispatch({
+      type: 'SET',
+      payload: {
+        message: msg,
+        messageColor: color
+      }
+    });
+  }
+
+  /**
+   * Sets a transient feedback message (e.g. validation errors). Auto-clears after `ms`.
+   */
   function setTimedMessage(msg) {
     var color = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'yellow';
     var ms = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 4000;
@@ -395,7 +414,7 @@ export function useContainerCreation(_ref) {
           step: 1
         }
       });
-      setTimedMessage('Optional: Enter container name or leave empty and press Enter', 'yellow');
+      setStepMessage('Optional: Enter container name or leave empty and press Enter', 'yellow');
       return;
     }
     if (step === 1) {
@@ -405,7 +424,7 @@ export function useContainerCreation(_ref) {
           step: 2
         }
       });
-      setTimedMessage('Optional: Enter ports (format 8080:80,443:443) or leave empty and press Enter', 'yellow');
+      setStepMessage('Optional: Enter ports (format 8080:80,443:443) or leave empty and press Enter', 'yellow');
       return;
     }
     if (step === 2) {
@@ -428,13 +447,13 @@ export function useContainerCreation(_ref) {
       var profile = imageProfiles[_baseName];
       if (profile && profile.requiredEnv && profile.requiredEnv.length) {
         var suggestedPart = profile.suggestedEnv && profile.suggestedEnv.length ? " | Suggested: ".concat(profile.suggestedEnv.join(', ')) : '';
-        setTimedMessage("Required env vars for ".concat(_baseName, ": ").concat(profile.requiredEnv.join(', '), ". Enter as VAR=val,VAR2=val2").concat(suggestedPart), 'yellow');
+        setStepMessage("Required env vars for ".concat(_baseName, ": ").concat(profile.requiredEnv.join(', '), ". Enter as VAR=val,VAR2=val2").concat(suggestedPart), 'yellow');
       } else if (profile && profile.suggestedEnv && profile.suggestedEnv.length) {
-        setTimedMessage("Suggested env vars for ".concat(_baseName, ": ").concat(profile.suggestedEnv.join(', '), ". Enter as VAR=val,VAR2=val2 or leave empty."), 'yellow');
+        setStepMessage("Suggested env vars for ".concat(_baseName, ": ").concat(profile.suggestedEnv.join(', '), ". Enter as VAR=val,VAR2=val2 or leave empty."), 'yellow');
       } else if (isDb) {
-        setTimedMessage('Warning: This image usually requires environment variables (e.g. MYSQL_ROOT_PASSWORD=my-secret-pw for MySQL, POSTGRES_PASSWORD=yourpassword for Postgres). Enter them as VAR=val,VAR2=val2 or leave empty and press Enter.', 'yellow');
+        setStepMessage('Warning: This image usually requires environment variables (e.g. MYSQL_ROOT_PASSWORD=my-secret-pw for MySQL, POSTGRES_PASSWORD=yourpassword for Postgres). Enter them as VAR=val,VAR2=val2 or leave empty and press Enter.', 'yellow');
       } else {
-        setTimedMessage('Optional: Enter environment variables (format VAR1=val1,VAR2=val2) or leave empty and press Enter', 'yellow');
+        setStepMessage('Optional: Enter environment variables (format VAR1=val1,VAR2=val2) or leave empty and press Enter', 'yellow');
       }
       return;
     }

package/dist/hooks/useContainerCommandRouter.js

@@ -16,6 +16,7 @@ import { useCallback } from 'react';
  *   l  — open logs viewer and start log stream
  *   c  — open container creation wizard (reset + activate)
  *   d  — toggle debug log panel
+ *   s  — open interactive shell in container
  *
  * @param {Object} params
  * @param {Object} params.actions       - API from useContainerActions
@@ -27,6 +28,7 @@ import { useCallback } from 'react';
  * @param {Function} params.onStartErase    - Callback: activates confirmErase state
  * @param {Function} params.onToggleDebug   - Callback: toggles showDebugLogs state
  * @param {Function} params.onStartCreate   - Callback: sets creatingContainer = true
+ * @param {Function} params.onOpenShell     - Callback: opens interactive shell
  * @returns {{ handleDockerCommands: Function }}
  */
 export function useContainerCommandRouter(_ref) {
@@ -38,7 +40,8 @@ export function useContainerCommandRouter(_ref) {
     startLogsStream = _ref.startLogsStream,
     onStartErase = _ref.onStartErase,
     onToggleDebug = _ref.onToggleDebug,
-    onStartCreate = _ref.onStartCreate;
+    onStartCreate = _ref.onStartCreate,
+    onOpenShell = _ref.onOpenShell;
   var handleDockerCommands = useCallback(function (input) {
     var container = containers[selected];
     if (input === 'i') {
@@ -143,8 +146,15 @@ export function useContainerCommandRouter(_ref) {
       onToggleDebug();
       return true;
     }
+    if (input === 's') {
+      if (!container) {
+        return true;
+      }
+      onOpenShell(container);
+      return true;
+    }
     return false;
-  }, [actions, containers, creation, logsViewer, onStartCreate, onStartErase, onToggleDebug, selected, startLogsStream]);
+  }, [actions, containers, creation, logsViewer, onStartCreate, onStartErase, onToggleDebug, onOpenShell, selected, startLogsStream]);
   return {
     handleDockerCommands: handleDockerCommands
   };

package/dist/hooks/useControls.js

@@ -22,6 +22,7 @@ import { useDebugLogs } from './debug/useDebugLogs.js';
 import { useEraseConfirmation } from './useEraseConfirmation.js';
 import { useExitHandler } from './useExitHandler.js';
 import { useContainerCommandRouter } from './useContainerCommandRouter.js';
+import { useShellMode } from './useShellMode.js';
 import { getLogsStream } from '../helpers/dockerService/serviceComponents/containerLogs.js';
 import { createContainer as svcCreateContainer } from '../helpers/dockerService/serviceComponents/containerActions.js';
 import { buildContainerOptions } from '../helpers/containerOptionsBuilder.js';
@@ -48,6 +49,7 @@ export function useControls() {
   var actions = useContainerActions({
     containers: containers
   });
+  var shellMode = useShellMode();
   var creation = useContainerCreation({
     onCreate: function () {
       var _onCreate = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref) {
@@ -176,6 +178,9 @@ export function useControls() {
     },
     onStartCreate: function onStartCreate() {
       return setCreatingContainer(true);
+    },
+    onOpenShell: function onOpenShell(container) {
+      return shellMode.openShell(container);
     }
   });
   var exitHandler = useExitHandler({

package/dist/hooks/useShellMode.js

@@ -0,0 +1,101 @@
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+import React from 'react';
+import { render } from 'ink';
+import { execInteractive, detectShell } from '../helpers/dockerService/serviceComponents/containerExec.js';
+import { getInkApp, setInkApp } from '../helpers/appState.js';
+import App from '../App.js';
+import { logger } from '../helpers/logger.js';
+
+/**
+ * Open an interactive shell inside a Docker container.
+ * Unmounts Ink, spawns `docker exec -it`, and re-renders the app on exit.
+ *
+ * @param {Object} container - Container object from Docker
+ * @returns {Promise<void>}
+ */
+function openShell(_x) {
+  return _openShell.apply(this, arguments);
+}
+/**
+ * Hook that provides the shell mode API.
+ * In practice, the heavy lifting (unmount/spawn/remount) is handled by
+ * `openShell` outside the React tree. This hook just exposes a stable
+ * reference for useControls.
+ *
+ * @returns {{ openShell: Function }}
+ */
+function _openShell() {
+  _openShell = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(container) {
+    var isRunning, containerId, containerName, inkApp, shell, newApp, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          if (container) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          isRunning = container.state === 'running' || container.status === 'running';
+          if (isRunning) {
+            _context.n = 2;
+            break;
+          }
+          logger.warn('Cannot open shell: container %s is not running', container.name);
+          return _context.a(2);
+        case 2:
+          containerId = container.id;
+          containerName = container.name || containerId.slice(0, 12); // Unmount Ink to release the terminal
+          inkApp = getInkApp();
+          if (inkApp && typeof inkApp.unmount === 'function') {
+            inkApp.unmount();
+          }
+
+          // Clear the screen for a clean shell experience
+          if (process.stdout && process.stdout.isTTY) {
+            process.stdout.write("\x1Bc");
+          }
+          _context.p = 3;
+          _context.n = 4;
+          return detectShell(containerId);
+        case 4:
+          shell = _context.v;
+          process.stdout.write("\x1B[36m[shell]\x1B[0m Opening ".concat(shell, " in ").concat(containerName, " (").concat(containerId.slice(0, 12), ")...\r\n"));
+          process.stdout.write('\x1b[33mType "exit" or press Ctrl+D to return to CDD.\x1b[0m\r\n\r\n');
+          _context.n = 5;
+          return execInteractive(containerId, {
+            shell: shell
+          });
+        case 5:
+          _context.n = 7;
+          break;
+        case 6:
+          _context.p = 6;
+          _t = _context.v;
+          process.stdout.write("\x1B[31m[shell] Error: ".concat(_t.message, "\x1B[0m\r\n"));
+          logger.error('Shell mode error', _t);
+        case 7:
+          _context.n = 8;
+          return new Promise(function (r) {
+            return setTimeout(r, 100);
+          });
+        case 8:
+          // Re-render the app
+          console.clear();
+          newApp = render(/*#__PURE__*/React.createElement(App, null));
+          setInkApp(newApp);
+        case 9:
+          return _context.a(2);
+      }
+    }, _callee, null, [[3, 6]]);
+  }));
+  return _openShell.apply(this, arguments);
+}
+export function useShellMode() {
+  return {
+    openShell: openShell
+  };
+}

package/dist/index.js

@@ -11,6 +11,7 @@ import React from 'react';
 import { render } from 'ink';
 import App from './App.js';
 import { logger } from './helpers/logger.js';
+import { setInkApp } from './helpers/appState.js';
 process.on('uncaughtException', function (err) {
   return logger.error('Uncaught exception', err);
 });
@@ -18,4 +19,5 @@ process.on('unhandledRejection', function (reason) {
   return logger.error('Unhandled rejection', reason);
 });
 console.clear();
-render(/*#__PURE__*/React.createElement(App, null));
+var inkApp = render(/*#__PURE__*/React.createElement(App, null));
+setInkApp(inkApp);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdd-cli",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "CLI Docker Dashboard",
   "main": "index.js",
   "scripts": {
@@ -16,6 +16,9 @@
   "author": "",
   "license": "ISC",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "chalk": "^5.6.2",
     "dockerode": "^4.0.9",