Guía de instalación

---

Índice

• Instalación rápida (Linux)
• Instalación rápida (Windows)
• macOS
• Opciones del instalador
• Compilar desde el código fuente
• Desinstalación
• Distribuciones compatibles

---

Instalación rápida (Linux)

El script de instalación detecta la distribución y su gestor de paquetes, instala los prerrequisitos de compilación (git y, si falta, el toolchain de Rust vía rustup), clona el repositorio, lo compila en modo release e instala el binario en /usr/local/bin.

Con curl

curl -fsSL https://raw.githubusercontent.com/xtop-cli/xtop/main/install.sh | bash

Con wget

wget -qO- https://raw.githubusercontent.com/xtop-cli/xtop/main/install.sh | bash

---

Instalación rápida (Windows)

Requiere Rust (Cargo) instalado. Ejecuta en PowerShell:

irm https://raw.githubusercontent.com/xtop-cli/xtop/main/install.ps1 | iex

---

macOS

install.sh está pensado para los gestores de paquetes de Linux y no tiene rama para macOS. Instala con cargo (necesita el toolchain de Rust de rustup):

cargo install --git https://github.com/xtop-cli/xtop --all-features

El binario acaba en ~/.cargo/bin; asegúrate de que esté en tu PATH. --all-features habilita el plugin Samurai, la extensión MCP, el pack de widgets blocks, el módulo de efectos y los dos hosts de widgets en tiempo de ejecución (WASM en sandbox y procesos externos).

---

Opciones del instalador

Puedes ejecutar el script de instalación con banderas adicionales para tener más control:

# Check dependencies without installing
./install.sh --check-deps

# Install only dependencies (Rust, build tools)
./install.sh --install-deps

# Install with the runtime widget hosts enabled (sandboxed .wasm widgets
# and helper processes in any language)
./install.sh --with-runtime-widgets

# Show help
./install.sh --help

En Windows el mismo opt-in es un switch del instalador:

.\install.ps1 -RuntimeWidgets

Distribuciones compatibles

• Arch Linux y derivados
• Debian / Ubuntu y derivados
• Fedora / RHEL y derivados
• openSUSE y derivados
• Alpine Linux y derivados

---

Compilar desde el código fuente

1. Clona el repositorio:

   git clone https://github.com/xtop-cli/xtop.git
   cd xtop

2. Compila y ejecuta con optimizaciones de release:

   cargo run --release

---

Desinstalación

Los desinstaladores eliminan solo el binario; la configuración de usuario bajo el directorio de configuración se conserva.

Linux

curl -fsSL https://raw.githubusercontent.com/xtop-cli/xtop/main/install.sh | bash -s -- --uninstall

Windows

irm https://raw.githubusercontent.com/xtop-cli/xtop/main/uninstall.ps1 | iex

---

Volver al README