Documentação

O Hangar depois da instalação

Tudo o que você precisa para o trabalho diário com o Hangar: do seu primeiro agente até os arquivos onde o Hangar guarda as suas configurações.

Primeiros passos

  1. Instale. Baixe o Hangar-Setup.exe e execute. O Hangar é instalado só para o seu usuário, sem direitos de administrador.
  2. 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.
  3. 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.
  4. 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.

Em qualquer lugar do Hangar
TeclasAção
Ctrl+Shift+PAcesso rápido: encontrar sessões, programas, arquivos, commits recentes, configurações e todos os comandos de menu
Ctrl+Shift+SBuscar na saída de todas as sessões
Ctrl+Shift+MMostrar todas as sessões como blocos ao vivo
Ctrl+Shift+HMostrar a tela inicial; as sessões continuam em execução
Ctrl+Shift+TNova sessão com o programa usado mais recentemente
Ctrl+Shift+WFechar a sessão
Ctrl+TabPróxima sessão
Ctrl+Shift+TabSessão anterior
Ctrl+Shift+AIr para a próxima sessão esperando por você
Ctrl+Shift+NNota rápida
Ctrl+Shift+DMostrar ou ocultar as alterações na pasta da sessão
Ctrl+Shift+FBuscar no histórico do terminal
Ctrl+Shift+BRecolher ou expandir a barra lateral
Ctrl+,Abrir as configurações
Ctrl++Texto maior
Ctrl+-Texto menor
Ctrl+0Redefinir o tamanho do texto
No terminal
TeclasAção
Ctrl+CCopiar a seleção; sem seleção, a tecla vai para o programa (interromper)
Ctrl+Shift+CCopiar a seleção e mantê-la selecionada
Ctrl+VColar; com uma imagem na área de transferência, o Hangar cola o caminho do arquivo de imagem salvo
Shift+EnterNova linha no prompt de um agente, sem enviá-lo
Ctrl+Shift+EspaçoSegure para ditar; a fala é reconhecida no seu próprio computador
Na busca do histórico
TeclasAção
EnterPróxima ocorrência
Shift+EnterOcorrência anterior
EscFechar a busca
Notas, barra lateral e envio para várias sessões
TeclasAção
F6 / Shift+F6Com as notas abertas, mover o foco entre o terminal, a lista de notas e o editor
F2Renomear a nota
Alt+↑ / Alt+↓Mover a sessão em foco para cima ou para baixo na barra lateral
Ctrl+EnterEnviar 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.

Campos de um perfil
CampoSignificado
idObrigatório. Único, sem espaços. O Hangar rejeita dois IDs que só diferem em letras maiúsculas e minúsculas.
nameObrigatório. Nome exibido na barra lateral.
commandObrigatório. Nome do programa no PATH ou um caminho completo. Sem sintaxe de shell: o Hangar inicia o programa diretamente.
argsArgumentos como lista, por exemplo ["--model", "opus"].
cwdPasta de trabalho fixa. Sem este campo, o programa inicia na pasta que você escolher.
iconUm 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_envNomes das variáveis cujos valores o Hangar guarda no Gerenciador de Credenciais do Windows, por exemplo ["GITHUB_TOKEN"].
resume_argsArgumentos para retomar a última conversa. Eles substituem args em vez de serem acrescentados.
version_argsArgumentos para consultar a versão, padrão ["--version"]; [] significa: nunca iniciar o programa para ler a versão.
latest, packages, self_update, update_hintOnde 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.

Locais de armazenamento
LocalConteúdo
%APPDATA%\com.feoren.hangar\profiles.tomlOs seus perfis
%APPDATA%\com.feoren.hangar\HANGAR.mdSuas instruções para todos os agentes
%APPDATA%\com.feoren.hangar\account.jsonO 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%\HangarO próprio programa
.hangar\notes\Notas compartilhadas, criptografadas, no repositório
Gerenciador de Credenciais do WindowsVariá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.

Contato para equipes