updated codespace and instructions

Author: scottyhq

.devcontainer/devcontainer.json

@@ -1,17 +1,37 @@
+// https://pixi.sh/latest/integration/editor/vscode/#devcontainer-extension
 {
-  "image": "quay.io/pangeo/pangeo-notebook:latest",
-  "postCreateCommand": {
-    "vscode": "mkdir ${containerWorkspaceFolder}/.vscode && cp ${containerWorkspaceFolder}/.devcontainer/tasks.json ${containerWorkspaceFolder}/.vscode/tasks.json"
-  },
-  "hostRequirements": {
-    "cpus": 2
+  "name": "xarray-tutorial",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": ".."
   },
   "customizations": {
-    "codespaces": {
-      "openFiles": ["README.md"]
-    },
     "vscode": {
-      "extensions": ["ms-toolsai.jupyter", "ms-python.python"]
+      "settings": {},
+      "extensions": [
+        "ms-toolsai.jupyter",
+        "ms-python.python",
+        "executablebookproject.myst-highlight"
+      ]
+    }
+  },
+  "features": {
+    // ensure GitHub Codespace 'Open with JupyterLab' works
+    // TODO: figure out why it doesn't work w/ jupyterlab in the pixi environment
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.12",
+      "installTools": false,
+      // NOTE: not working, so install with pip in postCreateCommand
+      // "toolsToInstall":"jupyterlab_myst,pixi-kernel",
+      "installJupyterlab": true
     }
+  },
+  "mounts": [
+    "source=${localWorkspaceFolderBasename}-pixi,target=${containerWorkspaceFolder}/.pixi,type=volume"
+  ],
+  "postCreateCommand": {
+    "configure_jupyterlab": "pip install jupyterlab_myst pixi-kernel",
+    "set_pixi_permissions": "sudo chown vscode .pixi",
+    "install_pixi_environment": "pixi install"
   }
 }

.devcontainer/tasks.json

@@ -24,12 +24,14 @@ This tutorial is available to run within [Github Codespaces](https://github.com/
 
 GitHub currently gives every user [120 vCPU hours per month for free](https://docs.github.com/en/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#monthly-included-storage-and-core-hours-for-personal-accounts), beyond that you must pay. **So be sure to explicitly stop or shut down your codespace when you are done by going to this page (https://github.com/codespaces).**
 
-Once your codespace is launched, the following happens:
+You can also use the GitHub CLI to launch a codespace
 
-- [Visual Studio Code](https://code.visualstudio.com/) Interface will open up within your browser.
-- A built in terminal will open and it will execute `jupyter lab` automatically.
-- Once you see a url to click within the terminal, simply `cmd + click` the given url.
-- This will open up another tab in your browser, leading to a [Jupyter Lab](https://jupyterlab.readthedocs.io/en/latest/) Interface.
+```
+# This will output a URL to use VSCode in the browser
+gh codespace create --repo xarray-contrib/xarray-tutorial
+# Optionally launch JupyterLab instead of vscode (after codespace has been created)
+gh codespace jupyter
+```
 
 #### Locally