diff --git a/.devcontainer/README.md b/.devcontainer/README.md
new file mode 100644
index 0000000..75173d3
--- /dev/null
+++ b/.devcontainer/README.md
@@ -0,0 +1,10 @@
+This folder contains a VS-Code development container definition. When opening
+the main poject in VS-Code with the remote-development
+(`ms-vscode-remote.vscode-remote-extensionpack`) extension installed, VS-Code
+should prompt to "reopen" the folder in a dev-container.
+
+When in this mode, any VS-Code console will run inside that container. The
+container contains the required development dependencies.
+
+Additional dependencies (more personalised by the original author) can be
+pulled in by executing `bash .devcontainer/init-dev.bash`.
diff --git a/.devcontainer/init-container.bash b/.devcontainer/init-container.bash
index 9d7edc2..b0c6d86 100644
--- a/.devcontainer/init-container.bash
+++ b/.devcontainer/init-container.bash
@@ -4,7 +4,5 @@ sudo apt update
 sudo apt -y install \
     libnotify-bin \
     pandoc \
-    jq \
-    vim-nox
-git clone https://github.com/exhuma/dotfiles /home/node/dotfiles
+    jq
 npm clean-install
diff --git a/.devcontainer/init-dev.bash b/.devcontainer/init-dev.bash
new file mode 100644
index 0000000..53700c5
--- /dev/null
+++ b/.devcontainer/init-dev.bash
@@ -0,0 +1,6 @@
+#!/bin/bash
+set -xe
+sudo apt update
+sudo apt -y install \
+    vim-nox
+git clone https://github.com/exhuma/dotfiles /home/node/dotfiles