Set up an Ubuntu terminal environment for development and operations with one Ansible run, and keep it up to date by running it again.
Proveasio installs and configures the tools: zsh, tmux, Neovim, Git helpers, Kubernetes and cloud CLIs, language version managers and AI coding agents. Every tool comes with customizations that make day-to-day terminal work faster.
Supported systems: Ubuntu 24.04 and Ubuntu 26.04, natively or on Windows WSL2. CI tests 26.04. On any other system, use the Docker image.
git clone https://github.com/Ziwi01/proveasio.git ~/proveasio
sudo ~/proveasio/prepare-ubuntu.sh
# close and reopen the terminal, then:
cd ~/proveasio/ansible && ansible-playbook -i inventory.yml setup-ubuntu.yml -KBefore the first run, set your git identity in ansible/vars/overrides.yml and read the installation guide.
Or build it as a Docker image:
git clone https://github.com/Ziwi01/proveasio.git ~/proveasio && cd ~/proveasio
USER_UID=$(id -u) USER_GID=$(id -g) docker buildx bake
mkdir -p ~/.local/bin && ln -s ~/proveasio/docker/proveasio ~/.local/bin/proveasio
proveasio init # then set PROVEASIO_IMAGE=proveasio:local in the file it prints
proveasio # from any project directory~/.local/bin must be on your PATH.
See Docker image.
A short summary of the included tools. For details see the documentation; for usage scenarios with examples, see Usage.
-
Shell: zsh with oh-my-zsh and the powerlevel10k theme: syntax highlighting, autosuggestions, history and file search with fzf, alias reminders, zoxide directory jumping and more.
-
tmux: splits shared with Neovim, saved and declarative sessions, fuzzy search of the scrollback.
-
Git:
- lazygit, with AI-generated commit messages and commit splitting
- diff-so-fancy, git-fuzzy and hunk for diffs and review
- revdiff to annotate diffs and plans and send the notes to opencode (
/revdiff) lswith Git status (eza), fzf branch checkout, many aliases- gita to run commands on groups of repositories
-
Containers and Kubernetes:
- Docker with Compose, and dry
- kubectl with kubecolor and kubeswitch
- k9s, kind, Helm with helm-unittest
- kubeconform, dyff
- stern (multi-pod logs), crane (registry CLI)
- Argo CD CLI and Argonaut
-
Infrastructure as code and cloud:
- Terraform, OpenTofu, Terragrunt, versioned per repository by tenv
- TFLint, terraform-docs, spacectl (Spacelift)
- Azure CLI with kubelogin and az-account-switcher
- AWS CLI with Granted, the Session Manager plugin, taws, eksctl, eks-node-viewer and Steampipe
-
Neovim: replaces Vim. The default config, based on AstroNvim, makes it a full IDE with language servers, Git tools and AI assistants. You can use your own config instead.
-
AI coding agents:
- opencode - terminal AI coding agent, also integrated into Neovim and lazygit
- shared OpenCode config - agents, skills and plugins for opencode, cloned and linked into
~/.config/opencode; you can use your own fork - ccmux - track AI coding agents in tmux: live session states, a status sidebar and picker, and desktop notifications (bridged to Windows toasts on WSL via wsl-notify-send)
-
Command-line tools: ripgrep, fd, bat, jq, yq, fx, curlie, htop, bottom, gdu, ShellCheck, pay-respects
-
Languages and toolchains (with version management): Python (pyenv, uv), Node (nvm), Go (gvm), Ruby (rvm), Java, Gradle, Groovy and Maven (SDKMAN!), Rust, plus Ansible and Puppet tooling.
- Requirements and Installation
- Docker image
- Customizations: version pins, excludes, partial runs
- Troubleshooting
Fork the repository, create a branch from develop, make your changes and open a pull request against develop. See TODO for ideas.
Before you open it, run the checks CI runs:
cd ansible && ansible-lint # must report "Passed: 0 failure(s)"
cd ansible && ansible-playbook -i inventory.yml setup-ubuntu.yml --syntax-check
cd docs-web && npm install && npm run build # fails on broken linksDo not run the full playbook on your own machine just to test a change. The Build workflow runs it on a clean Ubuntu runner.
Adding a tool takes five edits: a task file in ansible/roles/software/tasks/ (copy eza.yml or hunk.yml), its include in tasks/main.yml, a github_packages entry in vars/main.yml, a check_software_<tool> in docker/test.sh, and the docs in docs-web/docs/. Commits follow Conventional Commits with a capitalized subject, for example feat(software): Add curlie.
Thanks in advance!
Eryk 'Ziwi' Kozakiewicz
- Windows setup was inspired by and mostly based on lholota/dev-setup by Lukas Holota
- The SDKMAN! installation is based on Comcast/ansible-sdkman by Elliot Weiser

