Personal dotfiles for zsh, git, neovim, starship, and Ghostty.
dotfiles/
├── zsh/
│ ├── .zshrc # main shell config (oh-my-zsh + starship)
│ ├── .zshenv # env vars, PATH (sourced by all shells)
│ └── .zprofile # login shell config (brew on macOS/Linux, aliases)
├── git/
│ └── .gitconfig # git identity, LFS, gh credential helper
├── nvim/
│ └── init.vim # neovim config (vim-plug, gruvbox, coc.nvim)
├── config/
│ ├── starship.toml # prompt (needs a Nerd Font; Ghostty bundles one)
│ └── ghostty/config # terminal colors and font size
├── scripts/
│ ├── lib/platform.sh # OS detection shared by the scripts
│ └── setup-*.sh # optional tool setup (see below)
├── docs/ # setup guides and cheat sheets
├── Brewfile # packages installed by `brew bundle`
└── install.sh # bootstrap + symlinks (macOS, Linux, WSL)
Works on macOS, Linux (apt, dnf or pacman) and Windows via WSL2:
git clone https://github.com/0x48core/dotfiles ~/dotfiles
cd ~/dotfiles
./install.sh # prerequisites, Homebrew, Oh My Zsh, symlinks, Brewfile
./install.sh --no-packages # same, without `brew bundle`
./install.sh --links # symlinks onlyExisting files are moved to <file>.bak.<timestamp> before being linked. Rerunning is safe.
| Platform | Notes |
|---|---|
| macOS | Installs Xcode Command Line Tools first if missing |
| Linux | Run as your user (not root); see docs/linux.md for Docker and clipboard |
| Windows | Run inside WSL2 Ubuntu; see docs/wsl.md for the Windows side |
macOS-only Brewfile entries (ghostty, docker-desktop, multipass, google-cloud-sdk) are skipped on Linux and WSL.
- Shell: Oh My Zsh with a Starship prompt,
zsh-autosuggestions,zsh-syntax-highlighting, fzf key bindings (Ctrl-R, Ctrl-T) and zoxide (z) - CLI tools:
eza,bat,btop,lazydocker,jq,yq,gh - Aliases:
vim→nvim,k→kubectl(with completion);open,pbcopyandpbpastework on Linux and WSL too - Kubernetes:
kubectl,minikube,kind,k3d,helm,k9s,kubectx,stern,argocd - Infrastructure:
tenv(Terraform),ansible,doctl,cloud-sql-proxy, Google Cloud SDK - Other:
buf,grpcurl,trivy,mkcert,hey,k6,shellcheck,actionlint
See the Brewfile for the full list.
Optional, run them when you need them:
| Script | Purpose |
|---|---|
scripts/setup-ssh.sh <email> [host-alias] [key-name] |
SSH key and ~/.ssh/config for GitHub |
scripts/setup-gcloud.sh [project-id] |
Install and configure the Google Cloud CLI |
scripts/setup-k8s.sh [minikube|kind] [cluster-name] |
Local Kubernetes cluster |
scripts/setup-argocd.sh |
Install ArgoCD on the current kubectl context |
scripts/new-helm-chart.sh [name] [dest] |
Scaffold a Helm chart |
scripts/setup-terraform.sh [name] [dest] |
Bootstrap a Terraform project |
scripts/setup-go-tools.sh |
Common Go tools |
scripts/setup-grpc-gateway.sh |
grpc-gateway plugins for buf |
scripts/setup-jekyll.sh |
Homebrew Ruby and Jekyll |
- Platforms: Linux, Windows / WSL2
- Git & SSH: Git & GitHub CLI, SSH keys
- Kubernetes: Local clusters, Helm, ArgoCD
- Infrastructure: Terraform, Google Cloud
- Backend: Protobuf & gRPC, gRPC-Gateway, Database migrations
- Other: Ruby & Jekyll
Keep secrets out of this repo. Export them in ~/.zshenv.local (not tracked):
export ANTHROPIC_API_KEY="anthropic_api_key"
export DIGITALOCEAN_TOKEN="dop_v1_..." # terraform digitalocean providerzsh/.zshenv sources it automatically when present.
GitHub Actions runs shellcheck on the scripts, then on Ubuntu and macOS checks zsh syntax, runs ./install.sh --no-packages, makes sure the shell loads, and resolves the Brewfile.