new: create mux-0kmtui tool

mux-0kmtui/README.md

@@ -0,0 +1,95 @@
+# mux-0kmtui
+
+TUI (Text User Interface) for running commands on multiple VPS simultaneously via `0km vps-mux`.
+
+## Features
+
+- **Multi-server selection**: Select multiple servers with the spacebar
+- **Filter by name or tag**: Quickly search through your servers
+- **Multi-line commands**: Write complete bash scripts in the editor
+- **Script import**: Load `.sh` files to execute
+- **Parallel execution**: Run commands on all selected servers at once
+- **Real-time logs**: View output from each server in dedicated tabs
+- **Closable tabs**: Close individual tabs when done
+
+## Installation
+
+```bash
+cd mux-0kmtui
+pip install -e .
+```
+
+## Usage
+
+```bash
+mux-0kmtui
+```
+
+### Workflow
+
+1. **Filter** (optional): Type in the search bar to filter by name or tag
+2. **Select**: Check the servers (Space to toggle, or All/None buttons)
+3. **Command**: Type a command or load a script (Ctrl+O)
+4. **Execute**: Press `Ctrl+R` or click "Run"
+5. **Monitor**: View logs from each server in the tabs
+6. **Clean up**: Close tabs with the X button
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `F1` | Show help |
+| `Ctrl+Q` | Quit |
+| `Ctrl+R` | Run command |
+| `Ctrl+O` | Load .sh file |
+| `Ctrl+L` | Close all tabs |
+| `Ctrl+A` | Select all visible servers |
+| `Ctrl+D` | Deselect all visible servers |
+| `Escape` | Focus command input |
+| `Space` | Toggle server selection |
+
+## Configuration
+
+Configuration is read from (in order of priority):
+
+1. `~/.config/0kmtui/config.yml`
+2. `~/.config/0km/config.yml`
+3. `/etc/0km/config.yml`
+
+### Format
+
+```yaml
+hosts:
+  my-server.com:
+    host: my-server.com
+    tags: [prod, web]
+
+  staging.example.com:
+    host: staging.example.com
+    tags: [staging, api]
+
+  db-server:
+    host: 192.168.1.100
+    user: admin
+    port: 2222
+    tags: [prod, database]
+```
+
+### Fields
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `host` | Hostname or IP | (entry name) |
+| `user` | SSH user | `root` |
+| `port` | SSH port | `22` |
+| `tags` | List of tags for filtering | `[]` |
+
+## Requirements
+
+- Python 3.10+
+- `0km` command installed and in PATH (from [myc-manage](https://git.myceliandre.fr/Myceliandre/myc-manage))
+- SSH access to configured servers
+
+## License
+
+AGPL-3.0 - See [LICENSE](../LICENSE)