🐚 My Shell Setup

This project codifies how I configure my development environment across Windows, Linux, and OSX, using Windows Terminal¹, Powerlevel10k², Neovim³, and more.

🚀 Quick Start

Run this in a Linux (or Mac) terminal

curl -fsSL https://shell.jasonwohlgemuth.me/install.sh | bash

Tip

You can also pass package names to the script with curl -fsSL https://shell.jasonwohlgemuth.me/install.sh | bash -s -- <packages> where the list of packages can include any listed in the install packages section

🤓 Manual Setup

Make sure you have these things

• Git - easiest way to get the files within this project
• Stow - primary technology for configuration

Tip

For a given application configuration to be useful, the associated software must be installed

Clone this project

git clone https://github.com/jhwohlgemuth/my-shell-setup "${HOME}/.dotfiles"

Install packages

stow --dir "${HOME}/.dotfiles" --target "${HOME}" --stow git neovim ohmyposh powerlevel10k powershell

• elixir
  • IEx configuration - .iex.exs
• git
  • Configures Delta and adds some useful aliases - .gitconfig
• gold
  • Collection of utility functions and installation scripts. See the Gold project for motivation and example usage.
• neovim
  • Themes - themes/
  • Editor configuration - init.vim and general/
  • Plugin configuration - plug-config/
• ocaml
  • utop configuration - init.ml and .utoprc
• ohmyposh
  • Theme - .theme.omp.json
• powerlevel10k
  • Configuration - .p10k.zsh
• powershell
  • Profile - Microsoft.Powershell_profile.ps1
  • Settings - settings.json

Remove packages

stow --delete <package names> --target <target>

Docker rootless install

The gold/install_docker script now supports configuring Docker rootless mode for a non-root user.

• ROOTLESS_USER: Target Linux user for rootless Docker setup. Defaults to nonroot when omitted.
• ROOTLESS_ONLY: Defaults to 1 (rootless/client components only). Set to 0 to also install and start rootful Docker (docker.service).

Examples:

# Install rootless/client components only (default behavior)
ROOTLESS_USER=jason ./gold/install_docker

# Install rootful Docker and also configure rootless mode for user jason
ROOTLESS_USER=jason ROOTLESS_ONLY=0 ./gold/install_docker

After setup, use the rootless socket for that user session:

export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock

Update packages

cd "${HOME}/.dotfiles"
git pull origin main
stow --target <target> --restow <package>

🔮 What Next?!

Add or improve some packages and/or try developing with containers!

---

Footnotes

1

Windows Terminal is an open source terminal for the modern developer. Combined with Powershell, anyone can easily enjoy a comfortable and truly robust developer experience on Windows. #cantBelieveItsNotLinux

2

powerlevel10k is a theme for Zsh

3

Example Neovim configuration