odysseus-cli 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83fbeafc2b92417c763330d0917febf88b7f35a283449cd6be25c3a3b6f4de9f
-  data.tar.gz: aa37ee969336ceb718dde957b5ea8d762a6191ee4f5d629aa7c78e1c9a588721
+  metadata.gz: 9ab2bed3fffc294ecb32f75d6e1d63658b155d70a96527b001549650c2ae8097
+  data.tar.gz: 78d8ff320554b9e6f882475bfd751848b775412658c681e1ee69395385224969
 SHA512:
-  metadata.gz: bc38e11e61cdc48389853434fc7327c3c7ff00e3103cc1399bb4d2bfa943a827e09948794d4760f03b6644c6f07b8b5307d3f5ed00c9a2b2b8c49bbbd710ce93
-  data.tar.gz: 40e5da0f9800cb2188ebff426b1990bc8aa0061d13a79db4b27a599338912a287bb1369729b8c88fa89de70fd589c19ae2b4cd7d47a7b9ca5cc90907088dbad3
+  metadata.gz: 3cf3f0f9160960cee5e9cdad3f69bb805b62931a74fe81c46e2a967a788dd60f7c7beed834f28b6596283d64708c114e50a992b361c199afef4c7eb695e6624d
+  data.tar.gz: 5bfe356362ffb83d79330b6327a4417ad5b1ef0f244a3c420d9ed68dac23200545266a82bb4e69c373b7d63bea48cb7c70a87ab66cf2e21fea07a00435fa2d33

data/README.md

@@ -461,6 +461,50 @@ registry:
 
 For better security, you can store registry credentials in your encrypted secrets file and reference them.
 
+## Charm Mode (TUI)
+
+Odysseus CLI supports an optional **Charm mode** for a more glamorous terminal experience with spinners, styled output, tables, and interactive confirmations.
+
+### Enabling Charm Mode
+
+```bash
+# Via command-line flag
+odysseus deploy --charm --build
+
+# Via environment variable
+ODYSSEUS_CHARM=1 odysseus deploy --build
+```
+
+### Features in Charm Mode
+
+- **Styled headers** with rounded borders and colors
+- **Spinners** for long-running operations (build, deploy, pussh)
+- **Tables** for container and accessory status listings
+- **Confirmation dialogs** for destructive operations (cleanup, accessory remove)
+
+### Installing gum
+
+Charm mode requires [gum](https://github.com/charmbracelet/gum) to be installed:
+
+```bash
+# macOS
+brew install gum
+
+# Arch Linux
+pacman -S gum
+
+# Ubuntu/Debian (via charm tap)
+sudo mkdir -p /etc/apt/keyrings
+curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
+echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
+sudo apt update && sudo apt install gum
+
+# From source
+go install github.com/charmbracelet/gum@latest
+```
+
+If gum is not installed, Odysseus will warn you and fall back to standard output.
+
 ## Server Requirements
 
 Your target servers only need **Docker** installed. Odysseus automatically deploys and manages Caddy as a container (`odysseus-caddy`) - no manual Caddy installation required.

data/bin/odysseus

@@ -6,7 +6,11 @@ require 'odysseus/cli/cli'
 require 'optparse'
 
 def main
-  cli = Odysseus::CLI::CLI.new
+  # Check for charm mode via env var or flag
+  charm_mode = ENV['ODYSSEUS_CHARM'] == '1' || ARGV.include?('--charm')
+  ARGV.delete('--charm') # Remove so it doesn't interfere with command parsing
+
+  cli = Odysseus::CLI::CLI.new(charm_mode: charm_mode)
 
   commands = {
     'deploy' => { method: :deploy, needs_server: false },
@@ -241,6 +245,10 @@ end
 def print_help
   puts "Usage: odysseus <command> [options]"
   puts ""
+  puts "Global options:"
+  puts "  --charm                   Enable Charm TUI mode (requires gum)"
+  puts "                            Or set ODYSSEUS_CHARM=1 environment variable"
+  puts ""
   puts "Commands:"
   puts "  deploy                    Deploy all roles to servers defined in config"
   puts "  build                     Build Docker image (locally or on build host)"

data/lib/odysseus/cli/cli.rb

@@ -4,12 +4,22 @@ require 'odysseus'
 require 'pastel'
 require 'yaml'
 require 'tempfile'
+require_relative 'gum'
 
 module Odysseus
   module CLI
     class CLI
-      def initialize
+      def initialize(charm_mode: false)
         @pastel = Pastel.new
+        @charm = charm_mode && Gum.available?
+        if charm_mode && !Gum.available?
+          warn @pastel.yellow("Warning: --charm mode requested but 'gum' is not installed")
+          warn @pastel.dim("Install gum: https://github.com/charmbracelet/gum")
+        end
+      end
+
+      def charm?
+        @charm
       end
 
       # Deploy command - deploys all roles to their configured hosts
@@ -24,7 +34,12 @@ module Odysseus
         config = load_config(config_file)
         uses_registry = config[:registry] && config[:registry][:server]
 
-        puts @pastel.cyan("Odysseus Deploy")
+        # Header
+        if charm?
+          puts Gum.style("⛵ Odysseus Deploy", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Deploy")
+        end
         puts @pastel.blue("Service: #{config[:service]}")
         puts @pastel.blue("Image: #{config[:image]}:#{image_tag}")
         if should_build
@@ -37,33 +52,39 @@ module Odysseus
 
         # Build and distribute image if requested
         if should_build
-          puts @pastel.cyan("=== Building and distributing image ===")
-          result = executor.build_and_distribute(image_tag: image_tag)
+          if charm?
+            result = Gum.spin(title: 'Building and distributing image...') do
+              executor.build_and_distribute(image_tag: image_tag)
+            end
+          else
+            puts @pastel.cyan("=== Building and distributing image ===")
+            result = executor.build_and_distribute(image_tag: image_tag)
+          end
 
           if result[:build][:success]
-            puts @pastel.green("Build complete!")
+            puts @pastel.green("✓ Build complete!")
           else
-            puts @pastel.red("Build failed: #{result[:build][:error]}")
+            puts @pastel.red("✗ Build failed: #{result[:build][:error]}")
             exit 1
           end
 
           # Handle distribution result (either pussh or registry push)
           if uses_registry
             if result[:push][:success]
-              puts @pastel.green("Pushed to registry!")
+              puts @pastel.green("✓ Pushed to registry!")
             else
-              puts @pastel.red("Push to registry failed!")
+              puts @pastel.red("✗ Push to registry failed!")
               exit 1
             end
           else
             if result[:pussh][:success]
-              puts @pastel.green("Pussh complete!")
+              puts @pastel.green("✓ Pussh complete!")
               result[:pussh][:results]&.each do |host, host_result|
                 status = host_result[:success] ? @pastel.green('✓') : @pastel.red('✗')
                 puts "  #{status} #{host}"
               end
             else
-              puts @pastel.red("Pussh failed!")
+              puts @pastel.red("✗ Pussh failed!")
               result[:pussh][:results]&.each do |host, host_result|
                 status = host_result[:success] ? @pastel.green('✓') : @pastel.red('✗')
                 puts "  #{status} #{host}"
@@ -75,10 +96,20 @@ module Odysseus
           puts ""
         end
 
-        executor.deploy_all(image_tag: image_tag, dry_run: dry_run)
+        if charm?
+          Gum.spin(title: 'Deploying to servers...') do
+            executor.deploy_all(image_tag: image_tag, dry_run: dry_run)
+          end
+        else
+          executor.deploy_all(image_tag: image_tag, dry_run: dry_run)
+        end
 
         puts ""
-        puts @pastel.green("Deploy complete!")
+        if charm?
+          puts Gum.style("✓ Deploy complete!", foreground: '82', bold: true)
+        else
+          puts @pastel.green("Deploy complete!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -97,7 +128,11 @@ module Odysseus
         builder_config = config[:builder] || {}
         strategy = builder_config[:strategy] || :local
 
-        puts @pastel.cyan("Odysseus Build")
+        if charm?
+          puts Gum.style("🔨 Odysseus Build", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Build")
+        end
         puts @pastel.blue("Service: #{config[:service]}")
         puts @pastel.blue("Image: #{config[:image]}:#{image_tag}")
         puts @pastel.blue("Strategy: #{strategy}")
@@ -106,18 +141,29 @@ module Odysseus
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file, verbose: verbose)
-        result = executor.build(image_tag: image_tag, push: push, context_path: context_path)
+
+        if charm?
+          result = Gum.spin(title: 'Building image...') do
+            executor.build(image_tag: image_tag, push: push, context_path: context_path)
+          end
+        else
+          result = executor.build(image_tag: image_tag, push: push, context_path: context_path)
+        end
 
         if result[:success]
           puts ""
-          puts @pastel.green("Build complete!")
+          if charm?
+            puts Gum.style("✓ Build complete!", foreground: '82', bold: true)
+          else
+            puts @pastel.green("Build complete!")
+          end
           puts @pastel.blue("Image: #{result[:image]}")
           if result[:pushed]
             puts @pastel.blue("Pushed to registry: yes")
           end
         else
           puts ""
-          puts @pastel.red("Build failed: #{result[:error]}")
+          puts @pastel.red("✗ Build failed: #{result[:error]}")
           exit 1
         end
       rescue Odysseus::Error => e
@@ -135,7 +181,11 @@ module Odysseus
 
         config = load_config(config_file)
 
-        puts @pastel.cyan("Odysseus Pussh")
+        if charm?
+          puts Gum.style("📦 Odysseus Pussh", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Pussh")
+        end
         puts @pastel.blue("Service: #{config[:service]}")
         puts @pastel.blue("Image: #{config[:image]}:#{image_tag}")
         puts @pastel.blue("Build first: #{should_build ? 'yes' : 'no'}")
@@ -144,30 +194,46 @@ module Odysseus
         executor = Odysseus::Deployer::Executor.new(config_file, verbose: verbose)
 
         if should_build
-          result = executor.build_and_pussh(image_tag: image_tag)
+          if charm?
+            result = Gum.spin(title: 'Building and pushing image via SSH...') do
+              executor.build_and_pussh(image_tag: image_tag)
+            end
+          else
+            result = executor.build_and_pussh(image_tag: image_tag)
+          end
 
           if result[:build][:success]
-            puts @pastel.green("Build complete!")
+            puts @pastel.green("✓ Build complete!")
           else
-            puts @pastel.red("Build failed: #{result[:build][:error]}")
+            puts @pastel.red("✗ Build failed: #{result[:build][:error]}")
             exit 1
           end
         else
-          result = executor.pussh(image_tag: image_tag)
+          if charm?
+            result = Gum.spin(title: 'Pushing image via SSH...') do
+              executor.pussh(image_tag: image_tag)
+            end
+          else
+            result = executor.pussh(image_tag: image_tag)
+          end
         end
 
         pussh_result = should_build ? result[:pussh] : result
 
         if pussh_result[:success]
           puts ""
-          puts @pastel.green("Pussh complete!")
+          if charm?
+            puts Gum.style("✓ Pussh complete!", foreground: '82', bold: true)
+          else
+            puts @pastel.green("Pussh complete!")
+          end
           pussh_result[:results]&.each do |host, host_result|
             status = host_result[:success] ? @pastel.green('✓') : @pastel.red('✗')
             puts "  #{status} #{host}"
           end
         else
           puts ""
-          puts @pastel.red("Pussh failed!")
+          puts @pastel.red("✗ Pussh failed!")
           pussh_result[:results]&.each do |host, host_result|
             status = host_result[:success] ? @pastel.green('✓') : @pastel.red('✗')
             puts "  #{status} #{host}"
@@ -188,7 +254,12 @@ module Odysseus
         config = load_config(config_file)
         service_name = config[:service]
 
-        puts @pastel.cyan("Odysseus Status: #{service_name}")
+        if charm?
+          puts Gum.style("⛵ Odysseus Status", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Status: #{service_name}")
+        end
+        puts @pastel.blue("Service: #{service_name}")
         puts @pastel.blue("Server: #{server}")
         puts ""
 
@@ -199,10 +270,20 @@ module Odysseus
           caddy = Odysseus::Caddy::Client.new(ssh: ssh, docker: docker)
 
           # Web containers
-          puts @pastel.cyan("Web:")
+          if charm?
+            puts Gum.style(" Web ", foreground: '212', bold: true)
+          else
+            puts @pastel.cyan("Web:")
+          end
           web_containers = docker.list(service: service_name)
           if web_containers.empty?
             puts "  (no containers running)"
+          elsif charm?
+            rows = web_containers.map do |c|
+              health = c['Status'].include?('healthy') ? '✓' : ''
+              [c['Names'], c['State'], c['Image'], health]
+            end
+            puts Gum.table(headers: ['Name', 'State', 'Image', 'Health'], rows: rows)
           else
             web_containers.each do |c|
               status_color = c['State'] == 'running' ? :green : :red
@@ -227,17 +308,38 @@ module Odysseus
           # Job/worker containers (non-web roles)
           non_web_roles = config[:servers].keys.reject { |r| r == :web }
           if non_web_roles.any?
-            puts @pastel.cyan("Jobs/Workers:")
-            non_web_roles.each do |role|
-              role_service = "#{service_name}-#{role}"
-              containers = docker.list(service: role_service)
-              if containers.empty?
-                puts "  #{@pastel.yellow(role.to_s)}: #{@pastel.red('not running')}"
-              else
-                containers.each do |c|
-                  status_color = c['State'] == 'running' ? :green : :red
-                  puts "  #{@pastel.yellow(role.to_s)}: #{@pastel.send(status_color, c['State'])} #{c['Names']}"
-                  puts "    Image: #{c['Image']}"
+            if charm?
+              puts Gum.style(" Jobs/Workers ", foreground: '212', bold: true)
+            else
+              puts @pastel.cyan("Jobs/Workers:")
+            end
+
+            if charm?
+              rows = []
+              non_web_roles.each do |role|
+                role_service = "#{service_name}-#{role}"
+                containers = docker.list(service: role_service)
+                if containers.empty?
+                  rows << [role.to_s, 'stopped', '-', '-']
+                else
+                  containers.each do |c|
+                    rows << [role.to_s, c['State'], c['Names'], c['Image']]
+                  end
+                end
+              end
+              puts Gum.table(headers: ['Role', 'State', 'Name', 'Image'], rows: rows)
+            else
+              non_web_roles.each do |role|
+                role_service = "#{service_name}-#{role}"
+                containers = docker.list(service: role_service)
+                if containers.empty?
+                  puts "  #{@pastel.yellow(role.to_s)}: #{@pastel.red('not running')}"
+                else
+                  containers.each do |c|
+                    status_color = c['State'] == 'running' ? :green : :red
+                    puts "  #{@pastel.yellow(role.to_s)}: #{@pastel.send(status_color, c['State'])} #{c['Names']}"
+                    puts "    Image: #{c['Image']}"
+                  end
                 end
               end
             end
@@ -246,20 +348,36 @@ module Odysseus
 
           # Accessories
           if config[:accessories]&.any?
-            puts @pastel.cyan("Accessories:")
-            config[:accessories].each do |name, acc_config|
-              acc_service = "#{service_name}-#{name}"
-              containers = docker.list(service: acc_service, all: true)
-              running = containers.find { |c| c['State'] == 'running' }
-
-              if running
-                health = running['Status'].include?('healthy') ? ' (healthy)' : ''
-                puts "  #{@pastel.yellow(name.to_s)}: #{@pastel.green('running')}#{health}"
-                puts "    Image: #{acc_config[:image]}"
-                puts "    Container: #{running['ID'][0..11]}"
-              else
-                puts "  #{@pastel.yellow(name.to_s)}: #{@pastel.red('stopped')}"
-                puts "    Image: #{acc_config[:image]}"
+            if charm?
+              puts Gum.style(" Accessories ", foreground: '212', bold: true)
+              rows = config[:accessories].map do |name, acc_config|
+                acc_service = "#{service_name}-#{name}"
+                containers = docker.list(service: acc_service, all: true)
+                running = containers.find { |c| c['State'] == 'running' }
+                if running
+                  health = running['Status'].include?('healthy') ? '✓' : ''
+                  [name.to_s, 'running', acc_config[:image], running['ID'][0..11], health]
+                else
+                  [name.to_s, 'stopped', acc_config[:image], '-', '']
+                end
+              end
+              puts Gum.table(headers: ['Name', 'State', 'Image', 'Container', 'Health'], rows: rows)
+            else
+              puts @pastel.cyan("Accessories:")
+              config[:accessories].each do |name, acc_config|
+                acc_service = "#{service_name}-#{name}"
+                containers = docker.list(service: acc_service, all: true)
+                running = containers.find { |c| c['State'] == 'running' }
+
+                if running
+                  health = running['Status'].include?('healthy') ? ' (healthy)' : ''
+                  puts "  #{@pastel.yellow(name.to_s)}: #{@pastel.green('running')}#{health}"
+                  puts "    Image: #{acc_config[:image]}"
+                  puts "    Container: #{running['ID'][0..11]}"
+                else
+                  puts "  #{@pastel.yellow(name.to_s)}: #{@pastel.red('stopped')}"
+                  puts "    Image: #{acc_config[:image]}"
+                end
               end
             end
             puts ""
@@ -267,7 +385,11 @@ module Odysseus
 
           # TLS status for this service's domains
           if config[:proxy][:hosts]&.any?
-            puts @pastel.cyan("TLS:")
+            if charm?
+              puts Gum.style(" TLS ", foreground: '212', bold: true)
+            else
+              puts @pastel.cyan("TLS:")
+            end
             if caddy_status[:running] && caddy_status[:tls][:enabled]
               service_hosts = config[:proxy][:hosts]
               relevant_policy = caddy_status[:tls][:policies].find do |p|
@@ -297,7 +419,11 @@ module Odysseus
       def containers(server, options = {})
         config_file = options[:config] || 'deploy.yml'
 
-        puts @pastel.cyan("Odysseus Containers")
+        if charm?
+          puts Gum.style("📦 Odysseus Containers", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Containers")
+        end
         puts @pastel.blue("Server: #{server}")
         puts ""
 
@@ -311,6 +437,12 @@ module Odysseus
 
           if containers.empty?
             puts "No containers found for service: #{service_name}"
+          elsif charm?
+            puts Gum.style(" #{service_name} ", foreground: '212', bold: true)
+            rows = containers.map do |c|
+              [c['ID'][0..11], c['State'], c['Names'], c['Image'], c['Status']]
+            end
+            puts Gum.table(headers: ['ID', 'State', 'Name', 'Image', 'Status'], rows: rows)
           else
             puts @pastel.cyan("Containers for #{service_name}:")
             containers.each do |c|
@@ -362,14 +494,25 @@ module Odysseus
           exit 1
         end
 
-        puts @pastel.cyan("Odysseus Accessory Boot")
+        if charm?
+          puts Gum.style("🔌 Accessory Boot", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Boot")
+        end
         puts @pastel.blue("Accessory: #{name}")
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file)
-        executor.deploy_accessory(name: name)
 
-        puts @pastel.green("Accessory #{name} deployed!")
+        if charm?
+          Gum.spin(title: "Booting #{name}...") do
+            executor.deploy_accessory(name: name)
+          end
+          puts Gum.style("✓ Accessory #{name} deployed!", foreground: '82', bold: true)
+        else
+          executor.deploy_accessory(name: name)
+          puts @pastel.green("Accessory #{name} deployed!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -380,13 +523,24 @@ module Odysseus
       def accessory_boot_all(options = {})
         config_file = options[:config] || 'deploy.yml'
 
-        puts @pastel.cyan("Odysseus Accessory Boot All")
+        if charm?
+          puts Gum.style("🔌 Accessory Boot All", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Boot All")
+        end
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file)
-        executor.boot_accessories
 
-        puts @pastel.green("All accessories deployed!")
+        if charm?
+          Gum.spin(title: 'Booting all accessories...') do
+            executor.boot_accessories
+          end
+          puts Gum.style("✓ All accessories deployed!", foreground: '82', bold: true)
+        else
+          executor.boot_accessories
+          puts @pastel.green("All accessories deployed!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -403,14 +557,33 @@ module Odysseus
           exit 1
         end
 
-        puts @pastel.cyan("Odysseus Accessory Remove")
+        if charm?
+          puts Gum.style("🗑️  Accessory Remove", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Remove")
+        end
         puts @pastel.blue("Accessory: #{name}")
         puts ""
 
+        # Charm mode: ask for confirmation
+        if charm?
+          unless Gum.confirm("Remove accessory #{name}?")
+            puts @pastel.yellow("Cancelled.")
+            return
+          end
+        end
+
         executor = Odysseus::Deployer::Executor.new(config_file)
-        executor.remove_accessory(name: name)
 
-        puts @pastel.green("Accessory #{name} removed!")
+        if charm?
+          Gum.spin(title: "Removing #{name}...") do
+            executor.remove_accessory(name: name)
+          end
+          puts Gum.style("✓ Accessory #{name} removed!", foreground: '82', bold: true)
+        else
+          executor.remove_accessory(name: name)
+          puts @pastel.green("Accessory #{name} removed!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -427,14 +600,25 @@ module Odysseus
           exit 1
         end
 
-        puts @pastel.cyan("Odysseus Accessory Restart")
+        if charm?
+          puts Gum.style("🔄 Accessory Restart", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Restart")
+        end
         puts @pastel.blue("Accessory: #{name}")
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file)
-        executor.restart_accessory(name: name)
 
-        puts @pastel.green("Accessory #{name} restarted!")
+        if charm?
+          Gum.spin(title: "Restarting #{name}...") do
+            executor.restart_accessory(name: name)
+          end
+          puts Gum.style("✓ Accessory #{name} restarted!", foreground: '82', bold: true)
+        else
+          executor.restart_accessory(name: name)
+          puts @pastel.green("Accessory #{name} restarted!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -451,14 +635,25 @@ module Odysseus
           exit 1
         end
 
-        puts @pastel.cyan("Odysseus Accessory Upgrade")
+        if charm?
+          puts Gum.style("⬆️  Accessory Upgrade", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Upgrade")
+        end
         puts @pastel.blue("Accessory: #{name}")
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file)
-        executor.upgrade_accessory(name: name)
 
-        puts @pastel.green("Accessory #{name} upgraded!")
+        if charm?
+          Gum.spin(title: "Upgrading #{name}...") do
+            executor.upgrade_accessory(name: name)
+          end
+          puts Gum.style("✓ Accessory #{name} upgraded!", foreground: '82', bold: true)
+        else
+          executor.upgrade_accessory(name: name)
+          puts @pastel.green("Accessory #{name} upgraded!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1
@@ -469,7 +664,11 @@ module Odysseus
       def accessory_status(options = {})
         config_file = options[:config] || 'deploy.yml'
 
-        puts @pastel.cyan("Odysseus Accessory Status")
+        if charm?
+          puts Gum.style("🔌 Accessory Status", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Accessory Status")
+        end
         puts ""
 
         executor = Odysseus::Deployer::Executor.new(config_file)
@@ -477,6 +676,14 @@ module Odysseus
 
         if statuses.empty?
           puts "No accessories configured"
+        elsif charm?
+          rows = statuses.map do |status|
+            state = status[:running] ? 'running' : 'stopped'
+            container = status[:container_id] ? status[:container_id][0..11] : '-'
+            proxy = status[:has_proxy] ? '✓' : ''
+            [status[:name].to_s, status[:host], state, status[:image], container, proxy]
+          end
+          puts Gum.table(headers: ['Name', 'Host', 'State', 'Image', 'Container', 'Proxy'], rows: rows)
         else
           statuses.each do |status|
             status_text = status[:running] ? @pastel.green('running') : @pastel.red('stopped')
@@ -742,7 +949,12 @@ module Odysseus
         config = load_config(config_file)
         service_name = config[:service]
 
-        puts @pastel.cyan("Odysseus Cleanup: #{service_name}")
+        if charm?
+          puts Gum.style("🧹 Odysseus Cleanup", border: 'rounded', foreground: '212', padding: '0 1')
+        else
+          puts @pastel.cyan("Odysseus Cleanup: #{service_name}")
+        end
+        puts @pastel.blue("Service: #{service_name}")
         puts @pastel.blue("Server: #{server}")
         puts ""
 
@@ -766,6 +978,19 @@ module Odysseus
             service_names << "#{service_name}-#{name}"
           end
 
+          # Count containers to be removed
+          total_to_remove = service_names.sum do |svc|
+            docker.list(service: svc, all: true).size
+          end
+
+          # Charm mode: ask for confirmation
+          if charm? && total_to_remove > 0
+            unless Gum.confirm("Remove #{total_to_remove} container(s) for #{service_name}?")
+              puts @pastel.yellow("Cleanup cancelled.")
+              return
+            end
+          end
+
           puts @pastel.yellow("Removing containers for #{service_name}...")
 
           total_removed = 0
@@ -828,7 +1053,11 @@ module Odysseus
         end
 
         puts ""
-        puts @pastel.green("Cleanup complete!")
+        if charm?
+          puts Gum.style("✓ Cleanup complete!", foreground: '82', bold: true)
+        else
+          puts @pastel.green("Cleanup complete!")
+        end
       rescue Odysseus::Error => e
         puts @pastel.red("Error: #{e.message}")
         exit 1

data/lib/odysseus/cli/gum.rb

@@ -0,0 +1,156 @@
+# odysseus-cli/lib/odysseus/cli/gum.rb
+# Wrapper for Charm's gum CLI tool
+# https://github.com/charmbracelet/gum
+
+require 'open3'
+require 'tempfile'
+
+module Odysseus
+  module CLI
+    module Gum
+      class << self
+        # Check if gum is installed and available
+        def available?
+          @available ||= system('which gum > /dev/null 2>&1')
+        end
+
+        # Display a spinner while executing a block
+        # Returns the block's result
+        def spin(title:, spinner: 'dot')
+          return yield unless available?
+
+          result = nil
+          error = nil
+
+          # We can't use gum spin directly with Ruby blocks, so we show spinner
+          # and run the block in a thread
+          spin_pid = spawn("gum spin --spinner #{spinner} --title #{shell_escape(title)} -- sleep infinity",
+                           out: '/dev/null', err: '/dev/null')
+
+          begin
+            result = yield
+          rescue => e
+            error = e
+          ensure
+            Process.kill('TERM', spin_pid) rescue nil
+            Process.wait(spin_pid) rescue nil
+          end
+
+          raise error if error
+          result
+        end
+
+        # Interactive selection menu
+        # Returns selected option or nil if cancelled
+        def choose(options, header: nil)
+          return nil unless available?
+
+          args = ['gum', 'choose']
+          args += ['--header', header] if header
+          args += options
+
+          stdout, status = Open3.capture2(*args)
+          return nil unless status.success?
+
+          stdout.strip
+        end
+
+        # Yes/No confirmation dialog
+        # Returns true for yes, false for no
+        def confirm(message)
+          return true unless available?
+
+          system('gum', 'confirm', message)
+        end
+
+        # Style text with borders, colors, padding
+        def style(text, border: nil, foreground: nil, background: nil, padding: nil, margin: nil, bold: false)
+          return text unless available?
+
+          args = ['gum', 'style']
+          args += ['--border', border] if border
+          args += ['--foreground', foreground.to_s] if foreground
+          args += ['--background', background.to_s] if background
+          args += ['--padding', padding.to_s] if padding
+          args += ['--margin', margin.to_s] if margin
+          args << '--bold' if bold
+          args << text
+
+          stdout, status = Open3.capture2(*args)
+          status.success? ? stdout : text
+        end
+
+        # Display a table from headers and rows
+        # Returns formatted table string
+        def table(headers:, rows:)
+          return simple_table(headers, rows) unless available?
+
+          # gum table reads CSV from stdin
+          csv_data = [headers.join(',')]
+          rows.each do |row|
+            csv_data << row.map { |cell| csv_escape(cell.to_s) }.join(',')
+          end
+
+          stdout, status = Open3.capture2('gum', 'table', stdin_data: csv_data.join("\n"))
+          status.success? ? stdout : simple_table(headers, rows)
+        end
+
+        # Format text (markdown, code, etc.)
+        def format(text, type: 'markdown')
+          return text unless available?
+
+          stdout, status = Open3.capture2('gum', 'format', '-t', type, stdin_data: text)
+          status.success? ? stdout : text
+        end
+
+        # Display a log message with level styling
+        def log(message, level: 'info')
+          return puts(message) unless available?
+
+          system('gum', 'log', '-l', level, message)
+        end
+
+        # Join multiple styled blocks horizontally or vertically
+        def join(*texts, horizontal: false)
+          return texts.join("\n") unless available?
+
+          args = ['gum', 'join']
+          args << '--horizontal' if horizontal
+          args += texts
+
+          stdout, status = Open3.capture2(*args)
+          status.success? ? stdout : texts.join(horizontal ? ' ' : "\n")
+        end
+
+        private
+
+        def shell_escape(str)
+          "'#{str.gsub("'", "'\\\\''")}'"
+        end
+
+        def csv_escape(str)
+          if str.include?(',') || str.include?('"') || str.include?("\n")
+            "\"#{str.gsub('"', '""')}\""
+          else
+            str
+          end
+        end
+
+        # Fallback simple table for when gum is not available
+        def simple_table(headers, rows)
+          widths = headers.map.with_index do |h, i|
+            [h.to_s.length, rows.map { |r| r[i].to_s.length }.max || 0].max
+          end
+
+          lines = []
+          lines << headers.map.with_index { |h, i| h.to_s.ljust(widths[i]) }.join('  ')
+          lines << widths.map { |w| '-' * w }.join('  ')
+          rows.each do |row|
+            lines << row.map.with_index { |c, i| c.to_s.ljust(widths[i]) }.join('  ')
+          end
+          lines.join("\n")
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: odysseus-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Your Name
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: pastel
   requirement: !ruby/object:Gem::Requirement
@@ -76,6 +76,7 @@ files:
 - README.md
 - bin/odysseus
 - lib/odysseus/cli/cli.rb
+- lib/odysseus/cli/gum.rb
 homepage: https://github.com/WaSystems/odysseus
 licenses:
 - LGPL-3.0-only