new: create mux-0kmtui tool

mux-0kmtui/README.md

@@ -0,0 +1,64 @@
+# mux-0kmtui
+
+TUI for running commands on multiple VPS via `0km vps-mux`.
+
+## Features
+
+- **Server Selection**: Multi-select servers from your configured hosts
+- **Multi-line Commands**: Write complex bash scripts directly in the editor
+- **Script Import**: Load .sh files to execute on remote servers
+- **Command Execution**: Run commands on all selected servers simultaneously
+- **Live Output**: View real-time output from each server in dedicated tabs
+- **Closable Tabs**: Close individual server log tabs when no longer needed
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+```bash
+mux-0kmtui
+```
+
+### Workflow
+
+1. Select servers from the left panel (Space to toggle, or use All/None buttons)
+2. Type a command in the text area at the bottom (multi-line supported)
+   - Or click "Load .sh" to import a script file
+3. Press `Ctrl+R` or click "Run"
+4. View output from each server in dedicated tabs
+5. Close tabs with the X button when done
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Space` | Toggle server selection |
+| `Ctrl+A` | Select all servers |
+| `Ctrl+D` | Deselect all servers |
+| `Ctrl+R` | Run command |
+| `Ctrl+O` | Load .sh file |
+| `Ctrl+L` | Clear all log tabs |
+| `Escape` | Focus command input |
+| `q` | Quit |
+
+## Configuration
+
+Uses the same configuration as other 0kmtui tools:
+
+1. `~/.config/0kmtui/config.yml`
+2. `~/.config/0km/config.yml`
+3. `/etc/0km/config.yml`
+
+## Requirements
+
+- Python 3.10+
+- `0km` command installed and in PATH
+- SSH access to VPS hosts
+
+## License
+
+MIT