dotfiles.pro

Appearance

Changelog ​

All notable changes to this project will be documented here.

The format follows Keep a Changelog. This project is unreleased: the section below describes the upcoming first release as if the repository were a single commit, so it collapses rather than accumulates. A change to unreleased behavior amends or removes the entry it affects; only net-new capability adds one.

Unreleased ​

Added ​

  • Add the install.sh bootstrap: one command from a clean machine to Ansible + the collection + the dotpro CLI, then dotpro apply to converge (or DOTPRO_APPLY=1 to apply in the same run), with SSH key handoff and starter scaffolding
  • Add the dotpro CLI: apply, plan, upgrade, doctor, logs, dotfiles, and versions workflows over plain Ansible
  • Speed up dotpro apply (both on by default): merge every role's base-repo apt packages into one dpkg transaction, and overlap the download-heavy roles' fetches with the rest of the run via background async prefetch; dotpro apply --sequential opts back out to the per-role, one-at-a-time path
  • Add a collection-wide install-source policy (dotpro_install_source, with per-role <role>_install_source and per-tool overrides): prefer package-manager installs, or opt a role or tool into latest-upstream releases
  • Add SHA256 checksum verification to release downloads where upstream publishes checksums (kubectl, helm, doctl, k9s, kubeseal, yq, glab, gh)
  • Add per-tool version pinning (<role>_<tool>_version, default latest): pin any release-installed tool to an exact version that converges on every apply, or track the newest
  • Add ansible role: Ansible itself (apt or uv), Mitogen, and per-host roles_extra
  • Add dotfiles role: link, copy, or template raw dotfiles into $HOME, with backup and pruning
  • Add unix role: the OS-neutral base with the ~/.profile.d/ shell framework every platform role builds on
  • Add ubuntu role: base Ubuntu (and WSL) setup — apt upgrades, system packages, locale, optional snap packages (ubuntu_snaps), and sysctl tuning (ubuntu_sysctl)
  • Add macos role: base macOS setup with Homebrew as the package manager
  • Add wsl role: configure Windows Subsystem for Linux with wslu utilities and sensible defaults
  • Add windows role: manage Windows itself from inside WSL through the interop bridge, including opt-in Defender exclusions and power-plan tweaks
  • Add bash role: the bash login-file hygiene plus the shared alias, script, and version generators other roles import
  • Add zsh role: the zsh counterpart to bash, applied automatically when the host's login shell is zsh
  • Add nerdfonts role: install Nerd Fonts system-wide (FiraCode by default), on WSL also into the Windows per-user font store
  • Add starship role: install the Starship prompt and render a configurable prompt config
  • Add git role: Git config, aliases, the worktree CLI, and repository cloning
  • Add projects role: a bare jump alias per curated project (one that sets alias/title) plus project/projects/projectinfo commands rendered from the projects map, with tab completion over every project and per-shell context switching
  • Add github role: the gh CLI with PR/issue/run aliases and per-account context isolation
  • Add gitlab role: the glab CLI with MR/issue/pipeline aliases and per-account context isolation
  • Add python role: install Python 3 and pip and configure shell aliases
  • Add docker role: install Docker and Docker Compose, and manage Docker Desktop settings on WSL and macOS
  • Add kubernetes role: install kubectl, kubeseal, k9s, and Helm (with helm-diff and configurable extra plugins via kubernetes_helm_plugins) and 25+ shell aliases and functions
  • Add opentofu role: install OpenTofu (tofu) and configure shell aliases, with tab completion over workspace names
  • Add terraform role: install Terraform from HashiCorp's own package sources, with shell aliases and tab completion over workspace names
  • Add aws role: install the AWS CLI and AWSume for profile switching
  • Add digitalocean role: install doctl and configure shell aliases and functions
  • Add googlecloud role: install the Google Cloud CLI (gcloud) and configure shell aliases and functions
  • Add googleworkspace role: the gws CLI with mailbox aliases (inbox, mail-search, mail-read) and per-account context isolation; hosts whose glibc is too old for the upstream binaries (Ubuntu 22.04, Debian 12) skip the install with a note
  • Add sentry role: install sentry-cli (checksum-verified from the Sentry release registry) with project/issue/release aliases, bash completion, and per-account context isolation
  • Add agents role: render AGENTS.md, TOOLING.md, PROJECTS.md, SKILLS.md, and the worklog
  • Add claude role: install the Claude Code CLI and manage its settings, with per-account context isolation
  • Add terminal attention notifications: a shared ~/scripts/notify (bell + OSC 9, a native Windows toast on WSL, and an OSC 9;4 attention ring on the pinging tab in Windows Terminal) that the bash role's prompt hook fires when a foreground command fails and the claude role's notification hooks fire when a session needs your input or approval, so a tab you've switched away from flags itself; each ping is tagged with its source project and branch, the tab ring is coloured by reason (red failure, yellow approval, green waiting) and clears when the session regains focus, and on WSL clicking a toast brings up the Windows Terminal window and tab the pinging session lives in (a focus handler the windows role registers)
  • Add the projects variable, a machine-level project inventory: git_repositories defaults to it and the agents role renders PROJECTS.md from it
  • Add bitwarden role: install the Bitwarden CLI (bw) and configure shell aliases
  • Add ssh role: install Keychain for persistent SSH key management across shells
  • Add the starter examples (single, multiple, many) and the documentation site