Primeros pasos
- Instala. Descarga
Hangar-Setup.exey ejecútalo. Hangar se instala solo para tu usuario, sin derechos de administrador. - Inicia un agente. Elige una carpeta de proyecto en "Nueva sesión", elige Privada o Equipo y haz clic en un agente. Hangar muestra todos los agentes que encuentra en tu ordenador, con su versión; en Equipo, solo los que pueden ejecutarse como sesiones de equipo.
- Suma a tu equipo (opcional). Haz clic en "Iniciar sesión" en la parte inferior de la barra lateral, confirma el código en tu navegador y luego conecta el proyecto. Los compañeros que se unen al mismo proyecto se ven entre sí en la ventana Equipo.
- Foto de perfil (opcional). Tu foto de perfil de la cuenta de Hangar aparece en la barra lateral. La subes en este sitio web, en Cuenta › Ajustes.
Descargar Hangar Agentes compatibles
Si Windows muestra una advertencia de SmartScreen durante la instalación, elige "Más información" y luego "Ejecutar de todas formas". El instalador aún no está firmado con un certificado de firma de código. Las actualizaciones dentro de Hangar siempre están firmadas y verificadas.
Requisitos: Windows 10 versión 1809 o posterior, o Windows 11 (x64). Los agentes los instalas tú, con tus propias cuentas. Git es necesario para las sesiones de equipo (worktrees), el seguimiento de cambios, los commits y las notas compartidas.
Atajos de teclado
Hangar solo intercepta combinaciones que las shells y los agentes no necesitan. Sus equivalentes sin Mayús siguen llegando al programa en la terminal: Ctrl+B, Ctrl+F o Ctrl+P siguen llegando a tu shell o a tu agente.
| Teclas | Acción |
|---|---|
| Ctrl+Mayús+P | Acceso rápido: encontrar sesiones, programas, archivos, commits recientes, ajustes y todos los comandos de menú |
| Ctrl+Mayús+S | Buscar en la salida de todas las sesiones |
| Ctrl+Mayús+M | Mostrar todas las sesiones como mosaicos en vivo |
| Ctrl+Mayús+H | Mostrar la vista de inicio; las sesiones siguen funcionando |
| Ctrl+Mayús+T | Nueva sesión con el programa usado más recientemente |
| Ctrl+Mayús+W | Cerrar la sesión |
| Ctrl+Tab | Sesión siguiente |
| Ctrl+Mayús+Tab | Sesión anterior |
| Ctrl+Mayús+A | Ir a la siguiente sesión que te está esperando |
| Ctrl+Mayús+N | Nota rápida |
| Ctrl+Mayús+D | Mostrar u ocultar los cambios en la carpeta de la sesión |
| Ctrl+Mayús+F | Buscar en el historial de la terminal |
| Ctrl+Mayús+B | Contraer o expandir la barra lateral |
| Ctrl+, | Abrir la configuración |
| Ctrl++ | Texto más grande |
| Ctrl+- | Texto más pequeño |
| Ctrl+0 | Restablecer el tamaño del texto |
| Teclas | Acción |
|---|---|
| Ctrl+C | Copiar la selección; sin selección, la tecla va al programa (interrumpir) |
| Ctrl+Mayús+C | Copiar la selección y mantenerla seleccionada |
| Ctrl+V | Pegar; si hay una imagen en el portapapeles, Hangar pega la ruta del archivo de imagen guardado |
| Mayús+Enter | Nueva línea en el prompt de un agente, sin enviarlo |
| Ctrl+Mayús+Espacio | Mantener pulsado para dictar; la voz se reconoce en tu propio ordenador |
| Teclas | Acción |
|---|---|
| Enter | Coincidencia siguiente |
| Mayús+Enter | Coincidencia anterior |
| Esc | Cerrar la búsqueda |
| Teclas | Acción |
|---|---|
| F6 / Mayús+F6 | Con las notas abiertas, mover el foco entre la terminal, la lista de notas y el editor |
| F2 | Renombrar nota |
| Alt+↑ / Alt+↓ | Mover la sesión enfocada hacia arriba o hacia abajo en la barra lateral |
| Ctrl+Enter | Enviar un mensaje a varias sesiones |
Perfiles en profiles.toml
Tus propias terminales y agentes están en profiles.toml en la carpeta de configuración, en Windows %APPDATA%\com.feoren.hangar\profiles.toml. Si falta el archivo, Hangar lo crea al iniciarse a partir de una plantilla comentada, con PowerShell 7, Windows PowerShell y Símbolo del sistema.
La forma más rápida de abrir el archivo es en Configuración, en Terminales y agentes › Abrir archivo de perfiles.
Los agentes del catálogo no necesitan perfil, Hangar ya los conoce. Para iniciar uno de ellos de otra manera, crea un perfil con el mismo id: sustituye el nombre, el icono, el comando, los argumentos y la posición de la entrada del catálogo; la página del proyecto y el comando de instalación se mantienen del catálogo.
| Campo | Significado |
|---|---|
id | Obligatorio. Único, sin espacios. Hangar rechaza dos ID que solo se diferencian en mayúsculas y minúsculas. |
name | Obligatorio. Nombre que se muestra en la barra lateral. |
command | Obligatorio. Nombre del programa en el PATH o una ruta completa. Sin sintaxis de shell: Hangar inicia el programa directamente. |
args | Argumentos como lista, por ejemplo ["--model", "opus"]. |
cwd | Carpeta de trabajo fija. Sin este campo, el programa se inicia en la carpeta que elijas. |
icon | Uno o dos caracteres para el icono en la barra lateral. |
[profile.env] | Variables de entorno como una tabla propia. No pongas secretos aquí. |
secret_env | Nombres de variables cuyos valores Hangar guarda en el Administrador de credenciales de Windows, por ejemplo ["GITHUB_TOKEN"]. |
resume_args | Argumentos para reanudar la última conversación. Sustituyen a args en lugar de añadirse. |
version_args | Argumentos para consultar la versión, por defecto ["--version"]; [] significa: no iniciar nunca el programa para leer su versión. |
latest, packages, self_update, update_hint | Dónde se publican las nuevas versiones y cómo Hangar actualiza el programa con un clic. La plantilla comentada del archivo explica cada campo. |
Ejemplo
El primer perfil inicia Claude Code del catálogo con otro modelo. El segundo es una PowerShell propia con una carpeta de trabajo fija, una variable normal y una 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"
Variables secretas
Los valores de secret_env nunca aparecen en el archivo. Los introduces en Configuración, donde editas el perfil. Hangar los guarda en el Administrador de credenciales de Windows bajo el servicio hangar y solo los pasa al entorno de una sesión cuando esta se inicia. Una variable no puede aparecer a la vez en [profile.env] y en secret_env.
Después de guardar, Hangar vuelve a cargar el archivo en cuanto regresas a su ventana, o eliges "Recargar perfiles". Hangar muestra los errores con línea y columna; las sesiones en curso siguen como están.
Notificaciones de agentes en espera
La barra lateral muestra de un vistazo qué agente está trabajando, cuál ha terminado y cuál te está esperando. Todo lo demás está en Configuración, en Avisos.
- Resaltar sesiones en espera: una sesión pulsa suavemente cuando un agente ha terminado o te está esperando mientras miras otra cosa. Tú eliges tras cuántos segundos de calma aparece el aviso.
- Colores y pulso: Trabajando, Listo, Te pregunta y Pausa tienen cada uno su propio color, intensidad de pulso y duración de pulso, con vista previa.
- Sonido: un suave tono doble cuando espera una sesión que no estás viendo en ese momento. Si un programa termina con un error, suena más grave. El volumen se puede ajustar.
- Notificación de escritorio: solo mientras Hangar está en segundo plano. Haz clic en ella para abrir la sesión.
- Hacer parpadear la barra de tareas: solo mientras Hangar no está en primer plano. El parpadeo se detiene en cuanto cambias a su ventana.
- Contador en la barra de tareas: un pequeño icono en el botón de la barra de tareas muestra cuántas sesiones esperan, de 1 a 9 y 9+ a partir de ahí.
- Push al móvil: mediante ntfy o Pushover cuando una sesión te espera. Con ntfy, elige un tema difícil de adivinar, porque cualquiera que lo conozca puede leerlo todo.
- Horas de silencio: durante las horas que elijas no hay sonido, ni notificación, ni push al móvil, ni parpadeo en la barra de tareas. Los colores y el número de sesiones en espera se mantienen.
- Seguir en el área de notificación: al cerrar la ventana, tus sesiones siguen ejecutándose y el icono del área de notificación muestra cuántas están esperando. Para salir de Hangar, haz clic derecho en el icono.
Ctrl+Mayús+A te lleva directamente a la siguiente sesión en espera.
Sesiones de equipo y worktrees
En "Nueva sesión" eliges Privada o Equipo. Una sesión privada se ejecuta directamente en tu carpeta, solo para ti. Una sesión de equipo recibe su propio worktree de Git y es visible para tu equipo, así varios agentes pueden modificar el mismo proyecto a la vez sin quitarse los archivos unos a otros.
Para cada sesión de equipo, Hangar crea una rama hangar/… a partir del estado actual. Cuando un agente quiere editar un archivo en el que trabaja otra sesión, Hangar lo detiene y te pregunta; responde "siempre" o "nunca" para un archivo o una carpeta y Hangar lo recuerda por proyecto. Claude Code, Codex CLI, OpenCode y Pi funcionan como sesiones de equipo.
Los worktrees están en la carpeta de datos de la app, en %LOCALAPPDATA%\com.feoren.hangar\worktrees\, no junto a tu repositorio. Así los repositorios y las carpetas sincronizadas quedan limpios.
Cuando un agente arranca en un worktree nuevo, primero comprueba si hay commits nuevos en upstream y pregunta antes de traerlos. Puedes desactivarlo en Configuración, en Terminales y agentes.
Cuando termina una sesión de equipo, Hangar vuelve a eliminar su worktree, salvo que todavía contenga cambios o archivos ignorados como resultados de compilación, o que otra sesión siga trabajando en él. Si la rama tiene commits aún no fusionados, se mantiene. Hangar nunca fuerza nada.
Git debe estar instalado y la carpeta debe estar dentro de un repositorio Git. Hangar no ejecuta Git en recursos compartidos de red, y la comprobación antes de las ediciones no se aplica dentro de WSL.
Notas
Las notas pertenecen al proyecto de una sesión o al área General. Son archivos Markdown reales que también puedes abrir en el Explorador de archivos.
- Ctrl+Mayús+N inicia una nota rápida desde cualquier lugar.
- Envía el texto seleccionado de la terminal directamente a una nota, o una nota a una sesión. Allí se pega sin Enter, para que puedas revisarlo antes.
- Las notas eliminadas van a "Eliminadas recientemente", desde donde puedes restaurarlas.
- Arriba, en el panel de notas, cambias entre Privadas y Compartidas, así tus notas quedan separadas de las del equipo.
Notas compartidas y cifradas
Cuando activas las notas compartidas para un proyecto, Hangar las cifra y las guarda en la carpeta .hangar\notes\ del repositorio. Viajan con tus commits. Cualquiera que tenga el repositorio y el código puede leerlas. El texto descifrado nunca se escribe en disco, y Hangar nunca hace commits por su cuenta.
Al activarlas, Hangar muestra una sola vez un código de recuperación de notas. Guárdalo bien: sin él, las notas se pierden para siempre si este equipo pierde su clave. Con el código también las abres en otro clon.
Un archivo de instrucciones para todos los agentes
HANGAR.md está en la carpeta de configuración junto a profiles.toml y funciona como AGENTS.md o CLAUDE.md, solo que sin un archivo en tu repositorio. Hangar pasa su contenido a cada agente que acepta instrucciones adicionales: Claude Code, Codex CLI y Aider. Está activado por defecto; la plantilla está vacía y no envía nada hasta que escribas en ella.
Abres el archivo en Configuración, en Terminales y agentes › Abrir HANGAR.md. Allí también activas o desactivas «Usar HANGAR.md para cada agente». No escribas secretos en él: el texto aparece en la línea de comandos de los agentes.
Ubicaciones de almacenamiento
Hangar guarda su configuración en tu perfil de usuario, en Windows en %APPDATA% y %LOCALAPPDATA%. Solo las notas compartidas están en el proyecto.
| Ubicación | Contenido |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Tus perfiles |
%APPDATA%\com.feoren.hangar\HANGAR.md | Tus instrucciones para todos los agentes |
%APPDATA%\com.feoren.hangar\account.json | El servidor elegido y los servidores en los que has iniciado sesión; sin tokens |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Sesiones abiertas y su historial, para que Hangar las restaure tras un reinicio |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Notas privadas como archivos .md, por carpeta de proyecto y en general; las eliminadas en .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktrees de tus sesiones |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Capturas de pantalla pegadas; Hangar las elimina al cabo de una semana |
%LOCALAPPDATA%\Hangar | El propio programa |
.hangar\notes\ | Notas compartidas, cifradas, en el repositorio |
| Administrador de credenciales de Windows | Variables secretas de perfiles, tu inicio de sesión y las claves del equipo y de las notas compartidas |
Tu propio servidor de equipo
Para equipos, Hangar se conecta por defecto al servicio oficial en https://hangar.feoren.com/api/v1. Sin iniciar sesión, todo funciona salvo la ventana Equipo.
Si tu equipo tiene su propio servidor Hangar, introduce su dirección en Configuración, en Cuenta › Dirección del servidor (propio), y haz clic en Aplicar. Si lo dejas vacío, vuelve a usarse el servicio oficial.
La dirección es la base de la API del servidor, por ejemplo https://team.example.com/api/v1. Debe empezar por https://; Hangar solo permite http sin cifrar para localhost, 127.0.0.1 y [::1]. No se permiten nombre de usuario, contraseña, consulta ni fragmento. Hangar guarda la dirección en account.json; los inicios de sesión en otros servidores se quedan guardados en el dispositivo.
Un servidor así tiene que hablar la misma interfaz que el servicio oficial: inicio de sesión mediante el flujo de dispositivo de OAuth, cuenta y proyectos, además de tickets para el relay que transporta los datos del equipo por WebSocket. Los tipos de datos del protocolo y su cifrado son abiertos en el repositorio de la app, en los crates hangar-team-protocol y hangar-team-crypto bajo la licencia MIT.
Todo lo que se comparte con el equipo se cifra en tu dispositivo. El servidor lo almacena y lo reenvía, pero no puede leerlo. Los dispositivos nuevos solo se unen después de que alguien compare un número de seguridad y lo confirme.
Estado actual: Todavía no se ha publicado un software de servidor listo para alojarlo tú mismo. La app ya puede usar una dirección propia, pero aquí aún no hay una guía de instalación.
¿Planeas usar Hangar en una empresa y necesitas un servidor propio? Escríbenos y estudiaremos tu caso.