software
This role installs the tools. Each row below is one task file in ansible/roles/software/tasks/. Its name is both the tag (--tags <name>, see Run particular code) and the exclude name (software_tasks_exclude, see Excluding code).
Most tools are downloaded from their GitHub releases into ~/.local/opt/<tool>-<version> and linked into ~/.local/bin. Old versions are removed afterwards, see Cleaning up old versions.
Required
These cannot be excluded. The playbook stops at the start if software_tasks_exclude lists one of them.
| Name | Installs |
|---|---|
packages | Ubuntu packages from default_apt_packages: tree, htop, jq, bat, gh, gdu, keychain, rsync, sqlite3, command-not-found, build tools and more. Tag: software_packages. |
yq | yq - YAML, JSON and XML processor. The playbook itself uses it. |
zsh | oh-my-zsh plugins from omz_plugins and the powerlevel10k theme |
Shell and terminal
| Name | Installs |
|---|---|
tmux | tmux, built from source, with the tpm plugin manager |
fzf | fzf - fuzzy finder |
zoxide | zoxide - jump to visited directories |
eza | eza - modern ls, aliased as ls and ll, with zsh completion |
ripgrep | ripgrep - fast recursive grep |
fd | fd - fast find alternative |
fx | fx - terminal JSON viewer |
pay-respects | pay-respects - corrects the previous command |
bottom | bottom (btm) - system monitor |
curlie | curlie - curl frontend with HTTPie-style output; accepts all curl options |
shellcheck | ShellCheck - static analysis for shell scripts (latest release, newer than the Ubuntu package) |
w32yank | win32yank - Windows clipboard for Neovim on WSL |
Git
| Name | Installs |
|---|---|
git | Latest Git from the git-core PPA |
lazygit | lazygit - terminal UI for Git |
diff-so-fancy | diff-so-fancy - readable diffs |
git-fuzzy | git-fuzzy - Git commands in fzf |
gita | Gita - run commands on groups of repositories |
lsg | ls-with-git-status - ls with Git status |
hunk | hunk - terminal code review and diff viewer, with the hunk-review skill for opencode |
revdiff | revdiff - review diffs and plans with line annotations for AI agents, with its opencode plugin (/revdiff); sets untracked = true and word-diff = true in ~/.config/revdiff/config |
Editor
| Name | Installs |
|---|---|
neovim | Neovim, as an AppImage or a tarball (neovim_package). The config is installed by the config role. |
Languages and version managers
| Name | Installs |
|---|---|
nvm | NVM with the latest LTS Node (node_version) and the npm packages from npm_default_packages |
gvm | GVM with the Go versions from go_versions |
rvm | RVM (with rvm1-ansible) and the Rubies from rvm1_rubies (default ruby-3.4.7) |
sdkman | SDKMAN! with Java, Gradle, Groovy and Maven (sdkman_install_packages) |
rust | Rust with rustup and Cargo |
uv | uv - Python package and project manager |
ansible | Ansible and ansible-lint (pip), and the Ansible Language Server (npm, needs nvm) |
puppet | puppet and puppet-lint gems for the Rubies in puppet_rubies, PDK and Puppet Editor Services (needs rvm) |
Python itself is installed by prepare-ubuntu.sh with pyenv and pyenv-virtualenv, not by this role.
Containers and Kubernetes
| Name | Installs |
|---|---|
docker | Docker engine and the Compose plugin from Docker's APT repository (docker_apt_packages). With docker_manage_service: false and docker-ce: absent it installs only the client. |
dry | dry - terminal UI for Docker |
kubectl | kubectl, latest stable from dl.k8s.io |
kubecolor | kubecolor - colorized kubectl (aliased as kubectl) |
kubeswitch | kubeswitch (switch) - switch contexts and namespaces |
kind | kind - local Kubernetes clusters in Docker |
k9s | k9s - terminal UI for Kubernetes |
helm | Helm - Kubernetes package manager |
helm-unittest | helm-unittest - unit tests for Helm charts (helm unittest). A Helm plugin, so it needs helm. It is linked into helm_plugins_dir (default ~/.local/share/helm/plugins); a helm-unittest plugin installed there by other means is replaced. |
kubeconform | kubeconform - Kubernetes manifest validator |
dyff | dyff - YAML diff with Kubernetes-aware output |
argocd | Argo CD CLI with zsh completion |
argonaut | Argonaut - terminal UI for Argo CD; uses the session saved by argocd login |
stern | stern - tail logs of many pods and containers at once, filtered by name regex or label |
crane | crane - container registry CLI: list tags, copy images between registries, read digests and manifests without pulling |
Infrastructure as code and cloud
| Name | Installs |
|---|---|
tenv | tenv - version manager for Terraform, OpenTofu and Terragrunt. Links its proxies (terraform, tofu, terragrunt, terramate, tf, atmos) into ~/.local/bin. The tasks below need it. |
terraform | Terraform, installed with tenv. The repository picks the version. See Terraform, OpenTofu and Terragrunt versions. |
tofu | OpenTofu, installed with tenv, like terraform |
terragrunt | Terragrunt, installed with tenv, like terraform |
tflint | TFLint - Terraform linter; provider rulesets are set per project in .tflint.hcl |
terraform-docs | terraform-docs - generates the inputs and outputs documentation of a module |
spacectl | spacectl - Spacelift CLI: runs, logs, local previews |
azurecli | Azure CLI and kubelogin |
az-account-switcher | az-account-switcher (az-switch) |
awscli | AWS CLI v2 |
granted | Granted (assume) - switch AWS profiles and SSO roles in the current shell, open the console for a role |
session-manager-plugin | Session Manager plugin - lets aws ssm start-session open shells and port forwards without SSH. Unpacked from AWS's .deb, no sudo. |
taws | taws - terminal UI for AWS resources, in the style of k9s |
eksctl | eksctl - CLI for Amazon EKS clusters, node groups, add-ons and IAM service accounts |
eks-node-viewer | eks-node-viewer - live node usage against requests, with cost per node |
steampipe | Steampipe - SQL queries against cloud APIs. Plugins are not installed: run steampipe plugin install aws. |
Terraform, OpenTofu and Terragrunt versions
The repository decides the version. tenv's proxies look for it in this order, first match wins:
- an environment variable (
TFENV_TERRAFORM_VERSION,TOFUENV_TOFU_VERSION,TG_VERSION) - a version file in the directory or a parent:
.terraform-version(or.tfswitchrc),.opentofu-version,.terragrunt-version,.tool-versions - a version constraint in
terragrunt.hclorroot.hcl - the global default in
~/.tenv/<Terraform|OpenTofu|Terragrunt>/version, written bytenv tf use <version> - the newest installed version that satisfies
required_version
Proveasio installs the version from github_packages (latest by default) and does not write a global default: it would win over required_version. Outside a repository, the newest installed version runs. .zshrc sets TENV_AUTO_INSTALL=true, so a version a repository asks for is downloaded on first use. Proveasio never removes versions tenv installed; use tenv tf uninstall <version>.
Before tenv, Proveasio unpacked these tools into ~/.local/opt/<tool>-<version>. The first run with tenv deletes those directories and points ~/.local/bin/terraform, tofu and terragrunt at tenv's proxies. Pins in github_packages keep working.
Excluding tofu or terragrunt skips installing a version, but tenv's proxy for it stays on the PATH. With TENV_AUTO_INSTALL, calling it installs a version.
AI coding agents
| Name | Installs |
|---|---|
opencode | opencode - terminal AI coding agent. Installs v2 by default; pin a 1.x version to keep v1 (see opencode v1 and v2). Can also install with a preinstalled Homebrew (opencode_package: brew, see Install opencode with Homebrew). |
ccmux | ccmux - run and track AI coding agents (opencode, Claude Code, Codex and more) in tmux, with live session states, a sidebar and desktop notifications |
wsl-notify-send | wsl-notify-send - bridges ccmux notifications to Windows toasts on WSL |
Bundles
A bundle groups the tools for one purpose. Its name works as a tag (--tags terraform-tools) and as an exclude name (software_tasks_exclude: [terraform-tools]). You can still leave out single tools of a selected bundle:
ansible-playbook -i inventory.yml setup-ubuntu.yml --tags terraform-tools --skip-tags tofu -K
# ansible/vars/overrides.yml: everything AWS, except taws
software_tasks_exclude:
- azure-tools
- taws
| Bundle | Tools |
|---|---|
aws-tools | awscli, granted, session-manager-plugin, taws, eksctl, eks-node-viewer, steampipe |
azure-tools | azurecli, az-account-switcher |
kubernetes-tools | kubectl, kubecolor, kubeswitch, k9s, helm, helm-unittest, kubeconform, dyff, kind, stern, crane |
terraform-tools | tenv, terraform, tofu, terragrunt, tflint, terraform-docs |
argocd-tools | argocd, argonaut |
spacelift-tools | spacectl |
Bundles are defined in software_bundles in ansible/roles/software/vars/main.yml. Each member's include in tasks/main.yml carries the bundle tag; the playbook stops at the start if a member is not an include name.
Dependencies
What a tool needs, and what it installs besides itself. A tool listed under "Needs" must be installed too, by the same run or an earlier one.
| Tool | Needs | Also installs |
|---|---|---|
| every GitHub tool | packages (curl, jq, unzip), yq (version receipt) | |
zsh | packages | oh-my-zsh plugins, powerlevel10k |
ansible | Python (prepare-ubuntu.sh), nvm | ansible-lint, Ansible Language Server (npm) |
neovim config | nvm, gvm, rvm | language servers and tools through Mason (npm, go and gem packages) |
puppet | rvm | puppet, puppet-lint, PDK, Puppet Editor Services |
helm-unittest | helm | |
azurecli | kubelogin | |
terraform, tofu, terragrunt | tenv | |
tenv | proxies: terraform, tofu, terragrunt, terramate, tf, atmos | |
granted | assume, assumego | |
argonaut | argocd login (argocd login) | |
session-manager-plugin | awscli to be useful | |
ccmux | tmux | |
wsl-notify-send | WSL |
Configuration
Everything this role can configure is in ansible/roles/software/vars/main.yml. Override it in ansible/vars/overrides.yml, see Customizations. For example, to skip some tools:
software_tasks_exclude:
- azurecli
- puppet