csansoon/hostel-install

Instalar la CLI de Hostel y conectar

El binario hostel es el mismo para personas, agentes, servidores y máquinas de salas. Esta habilidad lo instala en el equipo de una persona y conecta ese equipo a un servidor. Para una máquina servidora, consulta hostel-server-setup. Para una máquina de sala, consulta hostel-rooms.

macOS y Linux

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh

El script descarga la última versión de GitHub, verifica el archivo contra SHA256SUMS de la versión, e instala hostel en ~/.local/bin.

Opciones (pónlas después de sh -s --):

Opción	Efecto
--dir DIR	Instala el binario en DIR (por defecto ~/.local/bin).
--version vX.Y.Z	Instala esta versión (por defecto: la última).
--server DIR	También instala los binarios de sala en DIR/helpers y los scripts de plataforma en DIR/platforms. Solo para una máquina servidora.

Ejemplos:

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0

Si el script imprime note: ... no está en tu PATH, añade el directorio al PATH en el perfil del shell, por ejemplo:

export PATH="$HOME/.local/bin:$PATH"

Compatible: macOS y Linux en amd64 o arm64. La variable de entorno HOSTEL_INSTALL_URL reemplaza la URL de descarga (un espejo).

Windows

En PowerShell (no se necesitan derechos de administrador):

irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex

El script instala hostel.exe en %LOCALAPPDATA%\Programs\hostel, lo verifica contra SHA256SUMS, y añade ese directorio al PATH del usuario. Abre una nueva terminal después de la primera instalación. $env:HOSTEL_VERSION (por ejemplo v0.1.0) selecciona una versión; $env:HOSTEL_INSTALL_URL establece un espejo.

Nota: install.ps1 es nuevo. Si falla, descarga hostel-windows-amd64.exe (o -arm64.exe) desde la versión de GitHub, renómbralo a hostel.exe, y colócalo en un directorio en el PATH.

Verificar la instalación

hostel --version
hostel help

Conectar el equipo a un servidor

Un administrador del servidor te da un código de invitación (hostel1-...). Funciona una vez, durante 24 horas. Consulta hostel-users para saber cómo un administrador crea uno.

hostel connect hostel1-...
hostel connect hostel1-... --name "Ejemplo Alicia"

• El nombre por defecto proviene de git config user.name. En una terminal, connect lo pide.
• La salida muestra el servidor, la clave TLS fijada (para un servidor con su propio certificado), tu rol y el nombre del equipo.
• La conexión se guarda en ~/.config/hostel/config.toml (modo 0600). En Windows está en el mismo lugar bajo %USERPROFILE%.
• Un equipo tiene como máximo una conexión. Si ya existe una, connect pregunta antes de reemplazarla. --yes la reemplaza sin preguntar.
• Los agentes en este equipo usan la misma conexión. No necesitan la suya propia.

Verifícala:

hostel status

Desconectar (el servidor elimina el token de este equipo):

hostel disconnect

Para pruebas y CI, las variables de entorno HOSTEL_SERVER, HOSTEL_TOKEN, y HOSTEL_SERVER_KEY anulan el archivo.

La aplicación Hostel

Ejecuta hostel sin argumentos en una terminal. Abre una aplicación de pantalla completa:

• No conectado: Registrarse (pegar el código de invitación, luego tu nombre) o Salir.
• Vestíbulo: las plataformas, sus máquinas libres, la cola y la espera.
• Salas: las máquinas, su estado y quién las usa.
• Recepción: el servidor y tú; Invitar a un invitado (administradores), Añadir tu otro equipo (miembros), Lista de invitados, Añadir una sala (administradores), Salir (desconectar).

Teclas: 1 2 3 van a Vestíbulo, Salas, Recepción; ? lista todas las techas; q sale. NO_COLOR=1 desactiva los colores. Sin una terminal (un agente, una tubería), hostel imprime la ayuda. Los agentes usan hostel status (texto plano).

Actualizar

Ejecuta el mismo comando de instalación otra vez. Reemplaza el binario.

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version

En Windows, ejecuta la línea irm ... | iex otra vez. La conexión se conserva.

Para la máquina servidora, también reinicia el servicio después de la actualización (hostel-server-setup, sección "Actualizar").

Siguiente

• Usar una sala: hostel-use.
• Si algo falla: hostel-troubleshoot.