65 lines
1.5 KiB
Markdown
65 lines
1.5 KiB
Markdown
# 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
|