odysseus-cli 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83fbeafc2b92417c763330d0917febf88b7f35a283449cd6be25c3a3b6f4de9f
-  data.tar.gz: aa37ee969336ceb718dde957b5ea8d762a6191ee4f5d629aa7c78e1c9a588721
+  metadata.gz: 286c6f613a97b1f0fe05e0fbe7c32134743f548a54963a3f118d8291ccebc792
+  data.tar.gz: 3d31e2e4a8d0a6bd64eb20d549d96b49a00885474a7c9fbd4467e9394bd254a0
 SHA512:
-  metadata.gz: bc38e11e61cdc48389853434fc7327c3c7ff00e3103cc1399bb4d2bfa943a827e09948794d4760f03b6644c6f07b8b5307d3f5ed00c9a2b2b8c49bbbd710ce93
-  data.tar.gz: 40e5da0f9800cb2188ebff426b1990bc8aa0061d13a79db4b27a599338912a287bb1369729b8c88fa89de70fd589c19ae2b4cd7d47a7b9ca5cc90907088dbad3
+  metadata.gz: 1a9f282b7f6c4380c28011bba65ed280ae791bbd27317aaf063e237a41d3a69ccd8de64dd24969f1664636b841897965070d2230a1949ce906b0b42cc98eed81
+  data.tar.gz: 33dfa6160b2db4ff12b1a31c6da6abaf22a8852d59b002cd82c029a231a00306e9df1cbeeb4727c615519dc97fa9ec3d62b3bab6a6732c52f9d71e9c405e1607

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
+  # Debug mode: verbose output with no spinners
+  debug_mode = ENV['ODYSSEUS_DEBUG'] == '1' || ARGV.include?('--debug')
+  ARGV.delete('--debug')
+
+  cli = Odysseus::CLI::CLI.new(debug: debug_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 "  --debug                   Verbose output (show all commands and details)"
+  puts "                            Or set ODYSSEUS_DEBUG=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)"