O cliente de linha de comandos hansa
O hansa é um cliente de linha de comandos sem estado para o seu workspace do
HansaChat. Foi criado para scripts, automatização e agentes de IA: cada comando
imprime JSON fiável por predefinição, e os comandos convergem para o estado que
pede — executar o mesmo comando duas vezes não duplica nada, exceto o envio de
mensagens, que por conceito é sempre uma mensagem nova.
A CLI fala com o seu workspace através do mesmo endereço web que a aplicação no
navegador (https://<workspace-domain>/api); nunca configura portas nem
caminhos de API. Aponte-a para o domínio do seu workspace, por exemplo
yourworkspace para yourworkspace.hansa.chat, e ela trata do resto.
Instalar com um comando
curl -fsSL https://downloads.hansachat.com/cli/install.sh | sh
O instalador deteta a sua plataforma (macOS ou Linux, Intel ou Apple Silicon),
verifica o checksum da transferência e instala o binário em ~/.local/bin.
Substitua o diretório com HANSA_INSTALL_DIR.
Também pode transferir o arquivo diretamente da página de transferências
e extrair o binário hansa você próprio.
Os seus primeiros comandos
# Log in to a workspace (prompts for email and password)
hansa chat login --workspace yourworkspace
# Confirm who you are
hansa chat whoami
# Explore
hansa chat channels list
hansa chat messages list --channel general
--workspace aceita um nome curto (yourworkspace torna-se yourworkspace.hansa.chat) ou um
domínio completo. Depois do primeiro início de sessão com sucesso, torna-se a
predefinição guardada, pelo que pode omitir a flag posteriormente. Mude a
predefinição com hansa context use.