Nicety for those using VSCode

.devcontainer/Dockerfile

@@ -0,0 +1,39 @@
+FROM ubuntu:22.04
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+RUN apt update && apt upgrade -y
+
+RUN apt update --fix-missing && apt install -y \
+	sudo \
+	build-essential \
+	curl \
+	git \
+	make \
+	python3 \
+	python-is-python3 \
+	wget
+
+RUN apt update --fix-missing && apt install -y \
+	clang \
+	llvm \
+	lld \
+	gdb \
+	qemu-system
+
+
+# Add custom user "dev" with sudo permissions
+RUN useradd dev -u 1000 -m -s /bin/bash && \
+	echo "dev ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
+USER dev
+
+
+# Install GEF for sanity & its dependencies
+RUN sudo apt install -y file && bash -c "$(wget https://gef.blah.cat/sh -O -)"
+
+# Terminal prompt customizations
+COPY custom/gu /usr/local/bin/gu
+COPY custom/.bashrc /home/dev/.bashrc
+RUN sudo chown dev:dev /usr/local/bin/gu
+RUN sudo chown dev:dev /home/dev/.bashrc
+

.devcontainer/custom/.bashrc

@@ -0,0 +1,56 @@
+# customized PS1 prompt to indicate we are in a container
+PS1="\W \e[01;31m$\e[m "
+
+# If not running interactively, don't do anything
+case $- in
+    *i*) ;;
+      *) return;;
+esac
+
+# don't put duplicate lines or lines starting with space in the history.
+# See bash(1) for more options
+HISTCONTROL=ignoreboth
+
+# append to the history file, don't overwrite it
+shopt -s histappend
+
+# for setting history length see HISTSIZE and HISTFILESIZE in bash(1)
+HISTSIZE=1000
+HISTFILESIZE=2000
+
+# custom
+alias l="ls -lah"
+alias ..="cd .."
+
+# git aliases
+alias gs="git status"
+alias gc="git commit -m "
+alias ga="git add "
+alias gp="git push"
+alias gpl="git pull"
+alias gl="git log --pretty=oneline"
+
+# check the window size after each command and, if necessary
+# update the values of LINES and COLUMNS.
+shopt -s checkwinsize
+
+# make less more friendly for non-text input files, see lesspipe(1)
+[ -x /usr/bin/lesspipe ] && eval "$(SHELL=/bin/sh lesspipe)"
+
+
+# Alias definitions in bash_aliases
+if [ -f ~/work/scripts/.bash_aliases ]; then
+    . ~/work/scripts/.bash_aliases
+fi
+
+# enable programmable completion features (you don't need to enable
+# this, if it's already enabled in /etc/bash.bashrc and /etc/profile
+# sources /etc/bash.bashrc).
+if ! shopt -oq posix; then
+  if [ -f /usr/share/bash-completion/bash_completion ]; then
+    . /usr/share/bash-completion/bash_completion
+  elif [ -f /etc/bash_completion ]; then
+    . /etc/bash_completion
+  fi
+fi
+

.devcontainer/devcontainer.json

@@ -0,0 +1,22 @@
+{
+    "name": "aos-dev",
+
+    "build": {
+        "dockerfile": "Dockerfile"
+    },
+
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "streetsidesoftware.code-spell-checker",
+            ]
+        }
+    },
+    "capAdd": ["SYS_PTRACE"],
+    "securityOpt": [ "seccomp=unconfined" ],
+
+    // If you need more ports forwarded, add them here
+    "forwardPorts": [
+    ],
+
+}

.gitignore

@@ -0,0 +1,5 @@
+.vscode
+__pycache__
+obj
+.gdbrc*
+*jos*

README.md

@@ -0,0 +1,4 @@
+Welcome to the OpenLSD framework.
+
+# Usage with VSCode and Docker
+VSCode ships an extension called [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) which allows you to open a repository inside of a Docker container that has all necessary development tools installed. This isolates your development environment from your host machine. Simply install the extension, then run the _"Dev Containers: Rebuild and Reopen inside Container"_ command from VSCode's command palette. It will take a while to build the container, however after that it will be cached and can be opened quickly.