Dotfiles

Opinionated workstation + Codespaces bootstrap.

Features

• Idempotent install.sh with:
  • Environment detection (local vs Codespaces)
  • Neovim install + minimal config bootstrap
  • Spaceship ZSH theme setup
  • Meslo Nerd Font install (skips if present)
  • Safe dotfile symlinking (backs up existing files)
  • Optional GitHub Copilot CLI extension
  • Delta (syntax highlighted pager) install
• Managed Codespaces SSH config export (export_codespace_cfg)
• Codespace cleanup utility (clean-codespaces.sh --dry-run)
• Shell linting via GitHub Actions + local make lint.

Quick Start

Clone then run:

./install.sh

Start a new shell (or source ~/.zshrc) to pick up changes.

Linting Shell Scripts

Run locally:

make lint

The CI workflow runs automatically on pushes and pull requests touching any *.sh files.

Codespaces SSH Config Export

./export_codespace_cfg

This inserts/updates a managed block in ~/.ssh/config between markers:

# >>> codespaces (managed) >>>
# <<< codespaces (managed) <<<

Cleaning Shutdown Codespaces

Preview:

./clean-codespaces.sh --dry-run

Execute deletions:

./clean-codespaces.sh

Future Ideas

• Brewfile / apt manifest abstraction
• Tmux plugin manager integration
• Advanced Neovim config module