From 23d67bbb70291bf3046c57c6768dc1727b1077b2 Mon Sep 17 00:00:00 2001
From: Ahmed Abdelhalim <pm@a14m.dev>
Date: Sun, 22 Feb 2026 18:56:01 +0100
Subject: Add gum role for beautiful CLIs

Co-Authored-By: claude.ai
---
 molecule/archlinux-gnome/converge.yml |  1 +
 molecule/archlinux/converge.yml       |  1 +
 molecule/debian/converge.yml          |  1 +
 molecule/raspberrypi/converge.yml     |  1 +
 molecule/ubuntu/converge.yml          |  1 +
 roles/gum/meta/argument_specs.yml     |  6 ++++++
 roles/gum/meta/main.yml               | 18 ++++++++++++++++++
 roles/gum/tasks/main.yml              | 11 +++++++++++
 8 files changed, 40 insertions(+)
 create mode 100644 roles/gum/meta/argument_specs.yml
 create mode 100644 roles/gum/meta/main.yml
 create mode 100644 roles/gum/tasks/main.yml

diff --git a/molecule/archlinux-gnome/converge.yml b/molecule/archlinux-gnome/converge.yml
index 9fdde413..ab22b57a 100644
--- a/molecule/archlinux-gnome/converge.yml
+++ b/molecule/archlinux-gnome/converge.yml
@@ -71,6 +71,7 @@
     - role: "gpg"
     - role: "btop"
     - role: "zoxide"
+    - role: "gum"
     - role: "git"
     - role: "git-crypt"
     - role: "dotfiles"
diff --git a/molecule/archlinux/converge.yml b/molecule/archlinux/converge.yml
index 1e333410..ee80aea4 100644
--- a/molecule/archlinux/converge.yml
+++ b/molecule/archlinux/converge.yml
@@ -71,6 +71,7 @@
     - role: "gpg"
     - role: "btop"
     - role: "zoxide"
+    - role: "gum"
     - role: "git"
     - role: "git-crypt"
     - role: "dotfiles"
diff --git a/molecule/debian/converge.yml b/molecule/debian/converge.yml
index e00c4e7f..0b9c8d70 100644
--- a/molecule/debian/converge.yml
+++ b/molecule/debian/converge.yml
@@ -81,6 +81,7 @@
     - role: "rust"
     - role: "nodejs"
     - role: "zoxide"
+    - role: "gum"
     - role: "usbutils"
     - role: "docker"
     - role: "podman"
diff --git a/molecule/raspberrypi/converge.yml b/molecule/raspberrypi/converge.yml
index 463678e3..f0e4733e 100644
--- a/molecule/raspberrypi/converge.yml
+++ b/molecule/raspberrypi/converge.yml
@@ -77,6 +77,7 @@
     - role: "rust"
     - role: "nodejs"
     - role: "zoxide"
+    - role: "gum"
     - role: "usbutils"
     - role: "wireguard"
     - role: "gateway"
diff --git a/molecule/ubuntu/converge.yml b/molecule/ubuntu/converge.yml
index 45389301..c632116c 100644
--- a/molecule/ubuntu/converge.yml
+++ b/molecule/ubuntu/converge.yml
@@ -70,6 +70,7 @@
     - role: "rust"
     - role: "nodejs"
     - role: "zoxide"
+    - role: "gum"
     - role: "usbutils"
     - role: "docker"
     - role: "podman"
diff --git a/roles/gum/meta/argument_specs.yml b/roles/gum/meta/argument_specs.yml
new file mode 100644
index 00000000..494333b5
--- /dev/null
+++ b/roles/gum/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install gum on Linux distributions"
+    description: "Install gum (charmbracelet) via Go on Linux distributions"
+    options: {}
diff --git a/roles/gum/meta/main.yml b/roles/gum/meta/main.yml
new file mode 100644
index 00000000..6cd0c978
--- /dev/null
+++ b/roles/gum/meta/main.yml
@@ -0,0 +1,18 @@
+---
+dependencies:
+  - role: "go"
+galaxy_info:
+  author: "a14m"
+  description: "Install gum (charmbracelet) via Go on Linux distributions"
+  license: "MIT"
+  min_ansible_version: "2.18"
+  platforms:
+    - name: "ArchLinux"
+      versions:
+        - "all"
+    - name: "Ubuntu"
+      versions:
+        - "noble"
+    - name: "Debian"
+      versions:
+        - "bookworm"
diff --git a/roles/gum/tasks/main.yml b/roles/gum/tasks/main.yml
new file mode 100644
index 00000000..6398a40f
--- /dev/null
+++ b/roles/gum/tasks/main.yml
@@ -0,0 +1,11 @@
+---
+- name: "Check if gum is installed"
+  ansible.builtin.stat:
+    path: "{{ ansible_facts['env']['HOME'] }}/go/bin/gum"
+  register: gum_binary
+
+- name: "Install gum via go"
+  ansible.builtin.command:
+    cmd: "/usr/local/go/bin/go install github.com/charmbracelet/gum@latest"
+  when: not gum_binary.stat.exists
+  changed_when: true
-- 
cgit v1.2.3