CommunityProgramação e Desenvolvimentogithub.com

csansoon/hostel-install

Instalar, atualizar ou verificar a CLI hostel no macOS, Linux ou Windows, e conectar o computador a um servidor Hostel. Use quando o usuário disser "instalar hostel", "atualizar hostel", "comando hostel não encontrado", "conectar ao nosso servidor Hostel", "tenho um código de convite", "desconectar" ou "abrir o aplicativo Hostel".

O que é hostel-install?

Esta skill instala o CLI `hostel` em computadores de usuários (macOS, Linux e Windows) e conecta o computador a um servidor Hostel. É útil para desenvolvedores e agentes que precisam configurar rapidamente o ambiente Hostel, seja para uso pessoal ou em CI/CD. Suporta instalação via script curl no macOS/Linux e via PowerShell no Windows, com opções de versão e diretório personalizados. A conexão com o servidor é feita através de um código de convite único, e o computador pode ser desconectado a qualquer momento. A skill também oferece um aplicativo de tela cheia para gerenciar plataformas, salas e convidados.

Funciona com~Claude Code~Codex CLI~Cursor
Part ofDesign & UI
npx skills add https://github.com/csansoon/hostel/tree/HEAD/skills/hostel-install

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

Instalar o CLI Hostel e conectar

O binário hostel é o mesmo para pessoas, agentes, servidores e máquinas de sala. Esta skill instala-o no computador de uma pessoa e conecta esse computador a um servidor. Para um servidor, veja hostel-server-setup. Para uma máquina de sala, veja hostel-rooms.

macOS e Linux

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

O script baixa a versão mais recente do GitHub, verifica o arquivo contra os SHA256SUMS da versão e instala o hostel em ~/.local/bin.

Opções (coloque-as após sh -s --):

OpçãoEfeito
--dir DIRInstala o binário em DIR (padrão ~/.local/bin).
--version vX.Y.ZInstala esta versão (padrão: a mais recente).
--server DIRTambém instala os binários de sala em DIR/helpers e os scripts de plataforma em DIR/platforms. Apenas para um servidor.

Exemplos:

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

Se o script imprimir note: ... is not on your PATH, adicione o diretório ao PATH no perfil do shell, por exemplo:

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

Suportado: macOS e Linux em amd64 ou arm64. A variável de ambiente HOSTEL_INSTALL_URL substitui a URL de download (um espelho).

Windows

No PowerShell (sem necessidade de privilégios de administrador):

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

O script instala hostel.exe em %LOCALAPPDATA%\Programs\hostel, verifica-o contra os SHA256SUMS e adiciona esse diretório ao PATH do usuário. Abra um novo terminal após a primeira instalação. $env:HOSTEL_VERSION (por exemplo v0.1.0) seleciona uma versão; $env:HOSTEL_INSTALL_URL define um espelho.

Nota: install.ps1 é novo. Se falhar, baixe hostel-windows-amd64.exe (ou -arm64.exe) da versão do GitHub, renomeie para hostel.exe e coloque-o em um diretório no PATH.

Verificar a instalação

hostel --version
hostel help

Conectar o computador a um servidor

Um administrador do servidor lhe fornece um código de convite (hostel1-...). Ele funciona uma vez, por 24 horas. Veja hostel-users para saber como um administrador cria um.

hostel connect hostel1-...
hostel connect hostel1-... --name "Alice Exemplo"
  • O nome padrão vem de git config user.name. Em um terminal, connect pergunta por ele.
  • A saída mostra o servidor, a chave TLS fixada (para um servidor com seu próprio certificado), seu papel e o nome do computador.
  • A conexão vai para ~/.config/hostel/config.toml (modo 0600). No Windows, fica no mesmo local abaixo de %USERPROFILE%.
  • Um computador tem no máximo uma conexão. Se existir uma, connect pergunta antes de substituí-la. --yes substitui sem a pergunta.
  • Agentes neste computador usam a mesma conexão. Eles não precisam da sua própria.

Verifique:

hostel status

Desconectar (o servidor exclui o token deste computador):

hostel disconnect

Para testes e CI, as variáveis de ambiente HOSTEL_SERVER, HOSTEL_TOKEN e HOSTEL_SERVER_KEY substituem o arquivo.

O aplicativo Hostel

Execute hostel sem argumentos em um terminal. Ele abre um aplicativo de tela cheia:

  • Não conectado: Check in (cole o código de convite, depois seu nome) ou Sair.
  • Lobby: as plataformas, suas máquinas livres, a fila e a espera.
  • Salas: as máquinas, seu estado e quem as usa.
  • Recepção: o servidor e você; Convidar um convidado (administradores), Adicionar seu outro computador (membros), Lista de convidados, Adicionar uma sala (administradores), Check out (desconectar).

Teclas: 1 2 3 vão para Lobby, Salas, Recepção; ? lista todas as teclas; q sai. NO_COLOR=1 desativa as cores. Sem um terminal (um agente, um pipe), hostel imprime a ajuda. Agentes usam hostel status (texto simples).

Atualizar

Execute o mesmo comando de instalação novamente. Ele substitui o binário.

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

No Windows, execute a linha irm ... | iex novamente. A conexão permanece.

Para o servidor, reinicie também o serviço após a atualização (hostel-server-setup, seção "Atualizar").

Próximos passos

  • Usar uma sala: hostel-use.
  • Algo falhou: hostel-troubleshoot.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

csansoon/hostel-platforms

Understand and change Hostel platforms - the defaults (ios, android, macos, windows, linux), what each needs on the machine, devices and labels, and your own platforms with their scripts. Use it when the user says "add iOS/Android to a machine", "what does the Mac need for iOS", "Android emulator does not start", "add a device", "make my own platform" (for example tvOS), or "change the provision/prepare script".

csansoon/hostel-rooms

Add, change, or remove the machines that give Hostel its rooms - a static host over SSH, a machine behind NAT that joins the server, Namespace on-demand machines, or your own external provider. Use it when the user says "add a Mac", "add a Windows machine", "add my Linux box", "the machine is behind NAT", "use Namespace", "more rooms", "drain/remove/repair a machine", or "destroy a room".

csansoon/hostel-server-setup

Set up, configure, back up, or update a Hostel server on a Linux VPS or a home machine. Use it when the user says "set up a Hostel server", "deploy hostel", "run hostel server", "put Hostel behind Caddy/a proxy", "change a server setting", "server.toml", "back up Hostel", or "update the server".

Habilidades Relacionadas

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More Programação e Desenvolvimento skills