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, and the dotpro CLI, with SSH key handoff and DOTPRO_APPLY=1 to apply in the same run
  • Add the dotpro CLI: apply, plan, upgrade, doctor, logs, dotfiles, and versions workflows over plain Ansible
  • Add dotpro suggest: see which roles your playbook is missing for products this machine already uses by hand, with the evidence per suggestion; each role lists the CLIs and config paths it detects by, in detect.yaml
  • Speed up dotpro apply by merging every role's apt packages into one transaction and prefetching the download-heavy roles in the background; --sequential opts back out
  • Add dotpro_install_source: prefer package-manager installs collection-wide, or opt a single 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 holds 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) 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 jump alias per curated project plus project, projects, and projectinfo commands rendered from the projects map, with 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 and per-account context isolation; hosts below glibc 2.39 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 atlassian role: install acli for Jira and Confluence from Atlassian's own package sources, with Jira/Confluence aliases 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 and MCP servers (claude_code_mcps), with per-account context isolation
  • Add terminal attention notifications: ~/scripts/notify pings a backgrounded tab (bell, OSC 9, Windows toast on WSL) when a command fails or a Claude Code session needs input
  • 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