Feature/devcontainers

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file. _(The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).)_
 
+## [33] - 2026-05-21
+
+### Added
+
+- Show devcontainer names below Docker container menu entries in smaller italic text when detected.
+- Show devcontainer local folder in a hover tooltip.
+- Open preferred IDE for devcontainer
+- Added configuration for devcontainer IDE
+
 ## [32] - 2026-04-27
 
 Added Gnome 50 support

README.md

@@ -21,10 +21,43 @@ The following actions are available from the GNOME Panel menu per Docker contain
 - **Exec** _(Will login to the running container interactively through your default terminal application.)_
 - **Logs** _(Will start the running container's Docker logs in your default terminal application.)_
 
+### Devcontainer support
+
+When a stopped container was created from a [Dev Container](https://containers.dev/) workspace (i.e. the workspace folder contains a `.devcontainer/devcontainer.json`), the extension shows additional information and actions:
+
+- The **devcontainer name** (from `devcontainer.json`) is displayed as a subtitle under the container entry.
+- The **workspace folder path** is shown as a clickable item — clicking it opens a terminal at that folder.
+- **Start** _(Runs `devcontainer up --workspace-folder <path>` to start the container and apply all lifecycle commands.)_
+- **Recreate and start** _(Runs `devcontainer up --remove-existing-container --workspace-folder <path>` to destroy the existing container and create a fresh one from the image.)_
+
+For **running** devcontainers, an additional action is available:
+
+- **Open in IDE** _(Runs the configured IDE command to attach your editor to the running container — see [IDE command](#post-recreate-command-ide-reattachment) below.)_
+
+> **Note:** these actions require the [`devcontainer` CLI](https://github.com/devcontainers/cli) to be installed and reachable on `PATH` (including version-manager-managed paths such as NVM or pyenv).
+
+#### Open in IDE command
+
+Configure a shell command in the extension preferences (_Devcontainer → Open in IDE command_) to attach your editor to a devcontainer. The command is triggered in two situations:
+
+- Clicking **Open in IDE** on any **running** devcontainer.
+- Automatically after a successful **Recreate and start** (since recreation replaces the container ID, causing IDEs to lose their connection).
+
+Use `%workspaceFolder%` as a placeholder for the workspace folder path. Examples:
+
+| IDE | Command |
+|-----|---------|
+| VS Code / Cursor | `code --folder-uri "vscode-remote://dev-container+$(printf '%s' '%workspaceFolder%' \| od -An -tx1 \| tr -dc '[:xdigit:]')/workspaceFolder"` |
+| Zed | `zed %workspaceFolder%` _(Zed detects the devcontainer and prompts to reopen)_ |
+| IntelliJ / JetBrains | No CLI hook available — reconnect manually from inside the IDE. |
+
+Leave the field empty to skip this step entirely.
+
 ## Prerequisite[^1]
 
 1. Properly installed and already running Docker service.
 2. Corresponding Linux user in `docker` Linux group for manage '_Docker_' without `sudo` permission.
+3. _(Devcontainer features only)_ [`devcontainer` CLI](https://github.com/devcontainers/cli) installed and on `PATH`.
 
 [^1]: independently from the extension itself
 

build.sh

@@ -3,5 +3,5 @@
 # Simple bash script to build the GNOME Shell extension
 echo "Zipping the extension..."
 glib-compile-schemas schemas
-zip -r easy_docker_containers@red.software.systems.zip . -x *.git* -x *.idea* -x *.history* -x *.*~ -x *.sh -x *.vscode/*
+zip -r easy_docker_containers@red.software.systems.zip . -x "*.git*" -x "*.idea*" -x "*.history*" -x "*.*~" -x "*.sh" -x "*.vscode/*" -x "schemas/gschemas.compiled" -x "venv/*"
 echo "Building is done."

metadata.json

@@ -3,7 +3,7 @@
   "uuid": "easy_docker_containers@red.software.systems",
   "description": "A GNOME Shell extension (GNOME Panel applet) to be able to generally control your available Docker containers.",
   "url": "https://github.com/RedSoftwareSystems/easy_docker_containers",
-  "version": 32,
-  "settings-schema": "red.software.systems.easy_docker_containers",
+  "version": 33,
+  "settings-schema": "org.gnome.shell.extensions.easy_docker_containers",
   "shell-version": ["45", "46", "47", "48", "49", "50"]
 }

prefs.js

@@ -7,6 +7,7 @@ import {
 } from "resource:///org/gnome/Shell/Extensions/js/extensions/prefs.js";
 
 import { makePrefCouterGroup } from "./src/prefPages/dockerPrefCounter.js";
+import { makePrefDevcontainerGroup } from "./src/prefPages/dockerPrefDevcontainer.js";
 
 const DOCKER_LOG_COMMAND =
   "'docker logs -f --tail 2000 %containerName%; exec $SHELL'";
@@ -113,9 +114,8 @@ export default class DockerContainersPreferences extends ExtensionPreferences {
   fillPreferencesWindow(window) {
     const settings = this.getSettings();
     const page = new Adw.PreferencesPage();
-    //const group = new Adw.PreferencesGroup();
-    const counterGroup = makePrefCouterGroup(settings);
-    page.add(counterGroup);
+    page.add(makePrefCouterGroup(settings));
+    page.add(makePrefDevcontainerGroup(settings));
 
     window.add(page);
   }

schemas/red.software.systems.easy_docker_containers.gschema.xml → schemas/org.gnome.shell.extensions.easy_docker_containers.gschema.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <schemalist>
-  <schema id="red.software.systems.easy_docker_containers" path="/red/software/systems/easy_docker_containers/">
+  <schema id="org.gnome.shell.extensions.easy_docker_containers" path="/org/gnome/shell/extensions/easy_docker_containers/">
     <!-- See also: https://docs.gtk.org/glib/gvariant-format-strings.html -->
     <key name="refresh-delay" type="i">
       <default>2</default>
@@ -17,5 +17,10 @@
     <key name="counter-enabled" type="b">
        <default>true</default>
     </key>
+    <key name="devcontainer-ide-command" type="s">
+      <default>''</default>
+      <summary>Command to open a devcontainer in the configured IDE</summary>
+      <description>Shell command executed when "Open in IDE" is clicked on a running devcontainer, and automatically after a successful recreate. Use %workspaceFolder% as a placeholder for the workspace path.</description>
+    </key>
   </schema>
 </schemalist>