Primeiros passos
- Instale. Baixe o
Hangar-Setup.exee execute. O Hangar é instalado só para o seu usuário, sem direitos de administrador. - Inicie um agente. Escolha uma pasta de projeto em "Nova sessão", escolha "Privada" ou "Equipe" e clique em um agente. O Hangar lista todos os agentes que encontra no seu computador, com a versão de cada um; em "Equipe", só os que podem rodar como sessões de equipe.
- Traga a sua equipe (opcional). Clique em "Entrar" na parte de baixo da barra lateral, confirme o código no navegador e depois conecte o projeto. Colegas que entram no mesmo projeto veem uns aos outros na janela Equipe.
- Foto de perfil (opcional). A sua foto de perfil da conta Hangar aparece na barra lateral. Você a envia neste site, em Conta › Configurações.
Baixar o Hangar Agentes compatíveis
Se o Windows mostrar um aviso do SmartScreen durante a instalação, escolha "Mais informações" e depois "Executar assim mesmo". O instalador ainda não está assinado com um certificado de assinatura de código. As atualizações dentro do Hangar são sempre assinadas e verificadas.
Requisitos: Windows 10 versão 1809 ou posterior, ou Windows 11 (x64). Você mesmo instala os agentes, com as suas próprias contas. O Git é necessário para sessões de equipe (worktrees), acompanhamento de alterações, commits e notas compartilhadas.
Atalhos de teclado
O Hangar só intercepta combinações de que shells e agentes não precisam. As equivalentes sem Shift continuam com o programa no terminal: Ctrl+B, Ctrl+F ou Ctrl+P continuam chegando ao seu shell ou agente.
| Teclas | Ação |
|---|---|
| Ctrl+Shift+P | Acesso rápido: encontrar sessões, programas, arquivos, commits recentes, configurações e todos os comandos de menu |
| Ctrl+Shift+S | Buscar na saída de todas as sessões |
| Ctrl+Shift+M | Mostrar todas as sessões como blocos ao vivo |
| Ctrl+Shift+H | Mostrar a tela inicial; as sessões continuam em execução |
| Ctrl+Shift+T | Nova sessão com o programa usado mais recentemente |
| Ctrl+Shift+W | Fechar a sessão |
| Ctrl+Tab | Próxima sessão |
| Ctrl+Shift+Tab | Sessão anterior |
| Ctrl+Shift+A | Ir para a próxima sessão esperando por você |
| Ctrl+Shift+N | Nota rápida |
| Ctrl+Shift+D | Mostrar ou ocultar as alterações na pasta da sessão |
| Ctrl+Shift+F | Buscar no histórico do terminal |
| Ctrl+Shift+B | Recolher ou expandir a barra lateral |
| Ctrl+, | Abrir as configurações |
| Ctrl++ | Texto maior |
| Ctrl+- | Texto menor |
| Ctrl+0 | Redefinir o tamanho do texto |
| Teclas | Ação |
|---|---|
| Ctrl+C | Copiar a seleção; sem seleção, a tecla vai para o programa (interromper) |
| Ctrl+Shift+C | Copiar a seleção e mantê-la selecionada |
| Ctrl+V | Colar; com uma imagem na área de transferência, o Hangar cola o caminho do arquivo de imagem salvo |
| Shift+Enter | Nova linha no prompt de um agente, sem enviá-lo |
| Ctrl+Shift+Espaço | Segure para ditar; a fala é reconhecida no seu próprio computador |
| Teclas | Ação |
|---|---|
| Enter | Próxima ocorrência |
| Shift+Enter | Ocorrência anterior |
| Esc | Fechar a busca |
| Teclas | Ação |
|---|---|
| F6 / Shift+F6 | Com as notas abertas, mover o foco entre o terminal, a lista de notas e o editor |
| F2 | Renomear a nota |
| Alt+↑ / Alt+↓ | Mover a sessão em foco para cima ou para baixo na barra lateral |
| Ctrl+Enter | Enviar uma mensagem para várias sessões |
Perfis no profiles.toml
Os seus próprios terminais e agentes ficam no profiles.toml na pasta de configuração, no Windows %APPDATA%\com.feoren.hangar\profiles.toml. Se o arquivo não existir, o Hangar o cria ao iniciar a partir de um modelo comentado, com PowerShell 7, Windows PowerShell e Prompt de Comando.
O jeito mais rápido de abrir o arquivo é nas Configurações, em Terminais e agentes › Abrir arquivo de perfis.
Os agentes do catálogo não precisam de perfil, o Hangar já os conhece. Para iniciar um deles de outro jeito, crie um perfil com o mesmo id: ele substitui o nome, o ícone, o comando, os argumentos e a posição da entrada do catálogo; a página do projeto e o comando de instalação continuam vindo do catálogo.
| Campo | Significado |
|---|---|
id | Obrigatório. Único, sem espaços. O Hangar rejeita dois IDs que só diferem em letras maiúsculas e minúsculas. |
name | Obrigatório. Nome exibido na barra lateral. |
command | Obrigatório. Nome do programa no PATH ou um caminho completo. Sem sintaxe de shell: o Hangar inicia o programa diretamente. |
args | Argumentos como lista, por exemplo ["--model", "opus"]. |
cwd | Pasta de trabalho fixa. Sem este campo, o programa inicia na pasta que você escolher. |
icon | Um ou dois caracteres para o ícone na barra lateral. |
[profile.env] | Variáveis de ambiente como uma tabela própria. Não coloque segredos aqui. |
secret_env | Nomes das variáveis cujos valores o Hangar guarda no Gerenciador de Credenciais do Windows, por exemplo ["GITHUB_TOKEN"]. |
resume_args | Argumentos para retomar a última conversa. Eles substituem args em vez de serem acrescentados. |
version_args | Argumentos para consultar a versão, padrão ["--version"]; [] significa: nunca iniciar o programa para ler a versão. |
latest, packages, self_update, update_hint | Onde as novas versões são publicadas e como o Hangar atualiza o programa com um clique. O modelo comentado no arquivo explica cada campo. |
Exemplo
O primeiro perfil inicia o Claude Code do catálogo com outro modelo. O segundo é um PowerShell próprio com uma pasta de trabalho fixa, uma variável comum e uma secreta.
[[profile]]
id = "claude"
name = "Claude Code (Opus)"
command = "claude"
args = ["--model", "opus"]
icon = "C"
[[profile]]
id = "pwsh-shop"
name = "PowerShell (Shop)"
command = "pwsh"
args = ["-NoLogo"]
cwd = 'C:\src\shop'
icon = "SH"
secret_env = ["GITHUB_TOKEN"]
[profile.env]
DOTNET_CLI_TELEMETRY_OPTOUT = "1"
Variáveis secretas
Os valores de secret_env nunca aparecem no arquivo. Você os informa nas Configurações, onde edita o perfil. O Hangar os guarda no Gerenciador de Credenciais do Windows sob o serviço hangar e só os coloca no ambiente de uma sessão quando ela inicia. Uma variável não pode aparecer ao mesmo tempo em [profile.env] e em secret_env.
Depois de salvar, o Hangar recarrega o arquivo assim que você volta para a janela dele, ou você escolhe "Recarregar perfis". O Hangar mostra um erro com linha e coluna; as sessões em andamento continuam como estão.
Notificações de agentes em espera
A barra lateral mostra de relance qual agente está trabalhando, qual terminou e qual está esperando por você. Todo o resto fica nas Configurações, em Avisos.
- Destacar sessões em espera: uma sessão pulsa suavemente quando um agente terminou ou está esperando por você enquanto você olha para outro lugar. Você escolhe depois de quantos segundos de silêncio o aviso aparece.
- Cores e pulsação: Trabalhando, Pronto, Pergunta a você e Pausa têm cada um a sua própria cor, intensidade e duração de pulsação, com pré-visualização.
- Som: um toque suave de dois tons quando espera uma sessão que você não está vendo no momento. Se um programa termina com erro, o som é mais grave. O volume é ajustável.
- Notificação na área de trabalho: só enquanto o Hangar está em segundo plano. Clique nela para abrir a sessão.
- Piscar a barra de tarefas: só enquanto o Hangar não está em primeiro plano. O piscar para assim que você muda para a janela dele.
- Contador na barra de tarefas: um pequeno ícone no botão da barra de tarefas mostra quantas sessões estão esperando, de 1 a 9 e 9+ acima disso.
- Push para o celular: pelo ntfy ou Pushover quando uma sessão espera por você. Com o ntfy, escolha um tópico difícil de adivinhar, porque qualquer pessoa que o conheça pode acompanhar.
- Horário de silêncio: nos horários que você escolher, não há som, notificação, push para o celular nem barra de tarefas piscando. As cores e o contador de sessões em espera continuam.
- Continuar na área de notificação: quando você fecha a janela, as suas sessões continuam rodando e o ícone na área de notificação mostra quantas estão esperando. Para sair do Hangar, clique com o botão direito no ícone.
Ctrl+Shift+A leva você direto para a próxima sessão em espera.
Sessões de equipe e worktrees
Em "Nova sessão" você escolhe "Privada" ou "Equipe". Uma sessão privada roda direto na sua pasta, só para você. Uma sessão de equipe ganha o seu próprio worktree do Git e fica visível para a sua equipe, para que vários agentes possam alterar o mesmo projeto ao mesmo tempo sem tirar arquivos debaixo uns dos outros.
Para cada sessão de equipe, o Hangar cria um branch hangar/… a partir do estado atual. Quando um agente quer editar um arquivo em que outra sessão está trabalhando, o Hangar o segura e pergunta a você; responda "sempre" ou "nunca" para um arquivo ou pasta e o Hangar lembra disso por projeto. Claude Code, Codex CLI, OpenCode e Pi rodam como sessões de equipe.
Os worktrees ficam na pasta de dados do app, em %LOCALAPPDATA%\com.feoren.hangar\worktrees\, e não ao lado do seu repositório. Assim, repositórios e pastas sincronizadas ficam limpos.
Quando um agente inicia em um worktree novo, ele primeiro verifica se há commits novos no upstream e pergunta antes de buscá-los. Você pode desativar isso nas configurações, em Terminais e agentes.
Quando uma sessão de equipe termina, o Hangar remove o worktree dela de novo, a menos que ele ainda tenha alterações ou arquivos ignorados, como resultados de build, ou que outra sessão ainda trabalhe nele. Se o branch tiver commits ainda não mesclados, ele é mantido. O Hangar nunca força nada.
O Git precisa estar instalado e a pasta precisa estar dentro de um repositório Git. O Hangar não executa o Git em compartilhamentos de rede, e a verificação antes de edições não se aplica dentro do WSL.
Notas
As notas pertencem ao projeto de uma sessão ou à área Geral. São arquivos Markdown de verdade, que você também pode abrir no Explorador de Arquivos.
- Ctrl+Shift+N inicia uma nota rápida de qualquer lugar.
- Envie o texto selecionado do terminal direto para uma nota, ou uma nota para uma sessão. Lá ele é colado sem Enter, para que você possa conferir antes.
- As notas excluídas vão para "Excluídas recentemente", onde você pode restaurá-las.
- No alto do painel de notas você alterna entre Privadas e Compartilhadas, assim as suas notas ficam separadas das da equipe.
Notas compartilhadas e criptografadas
Quando você ativa as notas compartilhadas para um projeto, o Hangar as criptografa e as guarda na pasta .hangar\notes\ do repositório. Elas viajam com os seus commits. Qualquer pessoa com o repositório e o código pode lê-las. O texto descriptografado nunca é gravado em disco, e o Hangar nunca faz commits por conta própria.
Ao ativar, o Hangar mostra uma única vez um código de recuperação das notas. Guarde-o bem: sem ele, as notas se perdem para sempre se este computador perder a chave. Com o código, você também as abre em outro clone.
Um arquivo de instruções para todos os agentes
HANGAR.md fica na pasta de configuração, ao lado de profiles.toml, e funciona como AGENTS.md ou CLAUDE.md, só que sem um arquivo no seu repositório. O Hangar repassa o conteúdo a cada agente que aceita instruções adicionais: Claude Code, Codex CLI e Aider. Fica ativado por padrão; o modelo está vazio e não envia nada até você escrever nele.
Você abre o arquivo nas configurações, em Terminais e agentes › Abrir HANGAR.md. Ali você também liga ou desliga “Usar HANGAR.md para todos os agentes”. Não coloque segredos nele: o texto aparece na linha de comando dos agentes.
Locais de armazenamento
O Hangar guarda as configurações no seu perfil de usuário, no Windows em %APPDATA% e %LOCALAPPDATA%. Só as notas compartilhadas ficam no projeto.
| Local | Conteúdo |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Os seus perfis |
%APPDATA%\com.feoren.hangar\HANGAR.md | Suas instruções para todos os agentes |
%APPDATA%\com.feoren.hangar\account.json | O servidor escolhido e os servidores em que você entrou; sem tokens |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Sessões abertas e o histórico delas, para que o Hangar as restaure após reiniciar |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Notas privadas como arquivos .md, por pasta de projeto e em general; as excluídas em .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktrees das suas sessões |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Capturas de tela coladas; o Hangar as exclui depois de uma semana |
%LOCALAPPDATA%\Hangar | O próprio programa |
.hangar\notes\ | Notas compartilhadas, criptografadas, no repositório |
| Gerenciador de Credenciais do Windows | Variáveis secretas de perfis, o seu login e as chaves da equipe e das notas compartilhadas |
O seu próprio servidor de equipe
Para equipes, o Hangar se conecta por padrão ao serviço oficial em https://hangar.feoren.com/api/v1. Sem entrar, tudo funciona, exceto a janela Equipe.
Se a sua equipe tem o próprio servidor Hangar, informe o endereço dele nas Configurações, em Conta › Endereço do servidor (próprio), e clique em Aplicar. Se ficar vazio, volta a valer o serviço oficial.
O endereço é a base da API do servidor, por exemplo https://team.example.com/api/v1. Ele precisa começar com https://; o Hangar só permite http simples para localhost, 127.0.0.1 e [::1]. Nome de usuário, senha, query e fragmento não são permitidos. O Hangar salva o endereço em account.json; os logins em outros servidores continuam salvos no dispositivo.
Um servidor assim precisa falar a mesma interface que o serviço oficial: login pelo fluxo de dispositivo OAuth, conta e projetos, além de tickets para o relay que transporta os dados da equipe por WebSocket. Os tipos de dados do protocolo e a criptografia dele são abertos no repositório do app, nos crates hangar-team-protocol e hangar-team-crypto sob a licença MIT.
Tudo o que é compartilhado com a equipe é criptografado no seu dispositivo. O servidor armazena e encaminha, mas não consegue ler. Novos dispositivos só entram depois que alguém compara um número de segurança e o confirma.
Situação atual: Ainda não foi publicado um software de servidor pronto para hospedagem própria. O app já consegue usar um endereço próprio, mas ainda não há um guia de instalação aqui.
Está planejando o Hangar para uma empresa e precisa de um servidor próprio? Escreva para nós e vamos analisar o seu caso.