Premiers pas
- Installer. Télécharge
Hangar-Setup.exeet lance-le. Hangar s'installe pour ton utilisateur uniquement, sans droits d'administrateur. - Lancer un agent. Choisis un dossier de projet sous « Nouvelle session », choisis Privée ou Équipe et clique sur un agent. Hangar liste tous les agents qu'il trouve sur ta machine, avec leur version ; sous Équipe, seulement ceux qui peuvent tourner en sessions d'équipe.
- Faire venir ton équipe (facultatif). Clique sur « Se connecter » en bas de la barre latérale, confirme le code dans ton navigateur, puis connecte le projet. Les coéquipiers qui rejoignent le même projet se voient mutuellement dans la fenêtre Équipe.
- Photo de profil (facultatif). Ta photo de profil du compte Hangar apparaît dans la barre latérale. Tu la téléverses sur ce site, sous Compte › Paramètres.
Télécharger Hangar Agents pris en charge
Si Windows affiche un avertissement SmartScreen pendant l'installation, choisis « Informations complémentaires » puis « Exécuter quand même ». Le programme d'installation n'est pas encore signé avec un certificat de signature de code. Les mises à jour dans Hangar sont toujours signées et vérifiées.
Configuration requise : Windows 10 version 1809 ou ultérieure, ou Windows 11 (x64). Tu installes les agents toi-même, avec tes propres comptes. Git est nécessaire pour les sessions d'équipe (worktrees), le suivi des modifications, les commits et les notes partagées.
Raccourcis clavier
Hangar n'intercepte que les combinaisons dont les shells et les agents n'ont pas besoin. Leurs équivalents sans Maj restent au programme dans le terminal : Ctrl+B, Ctrl+F ou Ctrl+P parviennent toujours à ton shell ou à ton agent.
| Touches | Action |
|---|---|
| Ctrl+Maj+P | Accès rapide : trouver des sessions, des programmes, des fichiers, des commits récents, des paramètres et chaque commande de menu |
| Ctrl+Maj+S | Chercher dans la sortie de toutes les sessions |
| Ctrl+Maj+M | Afficher toutes les sessions en tuiles en direct |
| Ctrl+Maj+H | Afficher la vue d'accueil ; les sessions continuent de tourner |
| Ctrl+Maj+T | Nouvelle session avec le dernier programme utilisé |
| Ctrl+Maj+W | Fermer la session |
| Ctrl+Tab | Session suivante |
| Ctrl+Maj+Tab | Session précédente |
| Ctrl+Maj+A | Aller à la prochaine session qui t'attend |
| Ctrl+Maj+N | Note rapide |
| Ctrl+Maj+D | Afficher ou masquer les modifications dans le dossier de la session |
| Ctrl+Maj+F | Rechercher dans l'historique du terminal |
| Ctrl+Maj+B | Réduire ou développer la barre latérale |
| Ctrl+, | Ouvrir les paramètres |
| Ctrl++ | Texte plus grand |
| Ctrl+- | Texte plus petit |
| Ctrl+0 | Réinitialiser la taille du texte |
| Touches | Action |
|---|---|
| Ctrl+C | Copier la sélection ; sans sélection, la touche va au programme (interruption) |
| Ctrl+Maj+C | Copier la sélection et la garder sélectionnée |
| Ctrl+V | Coller ; avec une image dans le presse-papiers, Hangar colle le chemin du fichier image enregistré |
| Maj+Enter | Nouvelle ligne dans le prompt d’un agent, sans l’envoyer |
| Ctrl+Maj+Espace | Maintenir pour dicter ; la parole est reconnue sur ton propre ordinateur |
| Touches | Action |
|---|---|
| Enter | Occurrence suivante |
| Maj+Enter | Occurrence précédente |
| Esc | Fermer la recherche |
| Touches | Action |
|---|---|
| F6 / Maj+F6 | Avec les notes ouvertes, déplacer le focus entre le terminal, la liste des notes et l'éditeur |
| F2 | Renommer la note |
| Alt+↑ / Alt+↓ | Déplacer la session active vers le haut ou vers le bas dans la barre latérale |
| Ctrl+Enter | Envoyer un message à plusieurs sessions |
Profils dans profiles.toml
Tes propres terminaux et agents se trouvent dans profiles.toml dans le dossier de configuration, sous Windows %APPDATA%\com.feoren.hangar\profiles.toml. Si le fichier n'existe pas, Hangar le crée au démarrage à partir d'un modèle commenté, avec PowerShell 7, Windows PowerShell et l'Invite de commandes.
Le moyen le plus rapide d'ouvrir le fichier est dans les Paramètres, sous Terminaux et agents › Ouvrir le fichier de profils.
Les agents du catalogue n'ont pas besoin de profil, Hangar les connaît déjà. Pour lancer l'un d'eux autrement, crée un profil avec le même id : il remplace le nom, l'icône, la commande, les arguments et la position de l'entrée du catalogue ; la page du projet et la commande d'installation restent celles du catalogue.
| Champ | Signification |
|---|---|
id | Obligatoire. Unique, sans espaces. Hangar refuse deux identifiants qui ne diffèrent que par les majuscules et minuscules. |
name | Obligatoire. Nom affiché dans la barre latérale. |
command | Obligatoire. Nom du programme dans le PATH ou chemin complet. Pas de syntaxe de shell : Hangar lance le programme directement. |
args | Arguments sous forme de liste, par exemple ["--model", "opus"]. |
cwd | Dossier de travail fixe. Sans ce champ, le programme démarre dans le dossier que tu choisis. |
icon | Un ou deux caractères pour l'icône dans la barre latérale. |
[profile.env] | Variables d'environnement dans une table à part. N'y mets pas de secrets. |
secret_env | Noms des variables dont Hangar conserve les valeurs dans le Gestionnaire d'identification de Windows, par exemple ["GITHUB_TOKEN"]. |
resume_args | Arguments pour reprendre la dernière conversation. Ils remplacent args au lieu de s'y ajouter. |
version_args | Arguments pour demander la version, par défaut ["--version"] ; [] signifie : ne jamais lancer le programme pour lire sa version. |
latest, packages, self_update, update_hint | Où les nouvelles versions sont publiées et comment Hangar met à jour le programme en un clic. Le modèle commenté dans le fichier explique chaque champ. |
Exemple
Le premier profil lance Claude Code du catalogue avec un autre modèle. Le second est un PowerShell à toi avec un dossier de travail fixe, une variable normale et une variable secrète.
[[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 secrètes
Les valeurs de secret_env n'apparaissent jamais dans le fichier. Tu les saisis dans les Paramètres, là où tu modifies le profil. Hangar les conserve dans le Gestionnaire d'identification de Windows sous le service hangar et ne les place dans l'environnement d'une session qu'au moment où elle démarre. Une variable ne doit pas figurer à la fois dans [profile.env] et dans secret_env.
Après l'enregistrement, Hangar recharge le fichier dès que tu reviens dans sa fenêtre, ou tu choisis « Recharger les profils ». Hangar affiche une erreur avec la ligne et la colonne ; les sessions en cours restent telles quelles.
Notifications pour les agents en attente
La barre latérale montre d'un coup d'œil quel agent travaille, lequel a terminé et lequel t'attend. Tout le reste se trouve dans les Paramètres, sous Mise en évidence.
- Mettre en évidence les sessions en attente : une session pulse doucement quand un agent a terminé ou t'attend pendant que tu regardes ailleurs. Tu choisis après combien de secondes de calme l'indication apparaît.
- Couleurs et pulsation : Travaille, Terminé, Te demande et Pause ont chacun leur propre couleur, intensité et durée de pulsation, avec un aperçu.
- Son : un léger carillon à deux tons quand une session que tu ne vois pas en ce moment attend. Si un programme se termine par une erreur, le son est plus grave. Le volume est réglable.
- Notification de bureau : seulement quand Hangar est en arrière-plan. Clique dessus pour ouvrir la session.
- Faire clignoter la barre des tâches : seulement quand Hangar n'est pas au premier plan. Le clignotement s'arrête dès que tu passes à sa fenêtre.
- Compteur dans la barre des tâches : une petite icône sur le bouton de la barre des tâches indique combien de sessions attendent, de 1 à 9, puis 9+ au-delà.
- Push sur ton téléphone : via ntfy ou Pushover quand une session t'attend. Avec ntfy, choisis un sujet difficile à deviner, car toute personne qui le connaît peut tout lire.
- Heures calmes : pendant les heures que tu choisis, pas de son, pas de notification, pas de push sur le téléphone et pas de clignotement dans la barre des tâches. Les couleurs et le nombre de sessions en attente restent.
- Rester dans la zone de notification : quand tu fermes la fenêtre, tes sessions continuent de tourner et l'icône de la zone de notification indique combien attendent. Pour quitter Hangar, fais un clic droit sur l'icône.
Ctrl+Maj+A t'amène directement à la prochaine session en attente.
Sessions d'équipe et worktrees
Sous « Nouvelle session », tu choisis Privée ou Équipe. Une session privée tourne directement dans ton dossier, rien que pour toi. Une session d'équipe obtient son propre worktree Git et est visible par ton équipe, pour que plusieurs agents puissent modifier le même projet en même temps sans se retirer les fichiers les uns aux autres.
Pour chaque session d'équipe, Hangar crée une branche hangar/… à partir de l'état actuel. Quand un agent veut modifier un fichier sur lequel une autre session travaille, Hangar le retient et te demande ; réponds « toujours » ou « jamais » pour un fichier ou un dossier et Hangar s'en souvient par projet. Claude Code, Codex CLI, OpenCode et Pi tournent en sessions d'équipe.
Les worktrees se trouvent dans le dossier de données de l'app, sous %LOCALAPPDATA%\com.feoren.hangar\worktrees\, et non à côté de ton dépôt. Les dépôts et les dossiers synchronisés restent ainsi propres.
Quand un agent démarre dans un worktree tout neuf, il vérifie d’abord s’il y a de nouveaux commits en amont et demande avant de les récupérer. Tu peux le désactiver dans les paramètres, sous Terminaux et agents.
Quand une session d'équipe se termine, Hangar supprime de nouveau son worktree, sauf s'il contient encore des modifications ou des fichiers ignorés comme des résultats de compilation, ou si une autre session y travaille encore. Si la branche a des commits pas encore fusionnés, elle est conservée. Hangar ne force jamais rien.
Git doit être installé et le dossier doit se trouver dans un dépôt Git. Hangar n'exécute pas Git sur les partages réseau, et la vérification avant les modifications ne s'applique pas dans WSL.
Notes
Les notes appartiennent au projet d'une session ou à la zone Général. Ce sont de vrais fichiers Markdown que tu peux aussi ouvrir dans l'Explorateur de fichiers.
- Ctrl+Maj+N commence une note rapide depuis n'importe où.
- Envoie le texte sélectionné du terminal directement dans une note, ou une note vers une session. Il y est collé sans Entrée, pour que tu puisses le vérifier d'abord.
- Les notes supprimées vont dans « Supprimées récemment », d'où tu peux les restaurer.
- En haut du panneau de notes, tu passes de Privées à Partagées : tes notes restent ainsi séparées de celles de l’équipe.
Notes partagées et chiffrées
Quand tu actives les notes partagées pour un projet, Hangar les chiffre et les conserve dans le dossier .hangar\notes\ du dépôt. Elles voyagent avec tes commits. Toute personne qui a le dépôt et le code peut les lire. Le texte déchiffré n'est jamais écrit sur le disque, et Hangar ne fait jamais de commit de lui-même.
À l'activation, Hangar affiche une seule fois un code de récupération des notes. Garde-le en lieu sûr : sans lui, les notes sont perdues pour de bon si cet ordinateur perd sa clé. Avec le code, tu les ouvres aussi sur un autre clone.
Un fichier d’instructions pour tous les agents
HANGAR.md se trouve dans le dossier de configuration, à côté de profiles.toml, et fonctionne comme AGENTS.md ou CLAUDE.md, mais sans fichier dans ton dépôt. Hangar transmet son contenu à chaque agent qui accepte des instructions supplémentaires : Claude Code, Codex CLI et Aider. C’est activé par défaut ; le modèle est vide et n’envoie rien tant que tu n’y écris rien.
Tu ouvres le fichier dans les paramètres, sous Terminaux et agents › Ouvrir HANGAR.md. Tu y actives ou désactives aussi « Utiliser HANGAR.md pour chaque agent ». N’y mets pas de secrets : le texte apparaît dans la ligne de commande des agents.
Emplacements de stockage
Hangar conserve ses paramètres dans ton profil utilisateur, sous Windows dans %APPDATA% et %LOCALAPPDATA%. Seules les notes partagées se trouvent dans le projet.
| Emplacement | Contenu |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Tes profils |
%APPDATA%\com.feoren.hangar\HANGAR.md | Tes instructions pour tous les agents |
%APPDATA%\com.feoren.hangar\account.json | Le serveur choisi et les serveurs auxquels tu es connecté ; aucun jeton |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Sessions ouvertes et leur historique, pour que Hangar les restaure après un redémarrage |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Notes privées en fichiers .md, par dossier de projet et sous general ; les notes supprimées dans .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktrees de tes sessions |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Captures d'écran collées ; Hangar les supprime au bout d'une semaine |
%LOCALAPPDATA%\Hangar | Le programme lui-même |
.hangar\notes\ | Notes partagées, chiffrées, dans le dépôt |
| Gestionnaire d'identification de Windows | Variables de profil secrètes, ta connexion et les clés de l'équipe et des notes partagées |
Ton propre serveur d'équipe
Pour les équipes, Hangar se connecte par défaut au service officiel à l'adresse https://hangar.feoren.com/api/v1. Sans connexion, tout fonctionne sauf la fenêtre Équipe.
Si ton équipe gère son propre serveur Hangar, saisis son adresse dans les Paramètres, sous Compte › Adresse du serveur (auto-hébergé), puis clique sur Appliquer. Si le champ reste vide, le service officiel s'applique à nouveau.
L'adresse est la base de l'API du serveur, par exemple https://team.example.com/api/v1. Elle doit commencer par https:// ; Hangar n'autorise le http simple que pour localhost, 127.0.0.1 et [::1]. Nom d'utilisateur, mot de passe, requête et fragment ne sont pas autorisés. Hangar enregistre l'adresse dans account.json ; les connexions à d'autres serveurs restent enregistrées sur l'appareil.
Un tel serveur doit parler la même interface que le service officiel : connexion par le flux d'appareil OAuth, compte et projets, ainsi que des tickets pour le relais qui transporte les données d'équipe par WebSocket. Les types de données du protocole et son chiffrement sont ouverts dans le dépôt de l'app, dans les crates hangar-team-protocol et hangar-team-crypto sous licence MIT.
Tout ce qui est partagé avec l'équipe est chiffré sur ton appareil. Le serveur le stocke et le transmet, mais ne peut pas le lire. Les nouveaux appareils ne rejoignent l'équipe qu'après que quelqu'un a comparé un numéro de sécurité et l'a confirmé.
Où en sont les choses : Aucun logiciel serveur prêt à l'emploi pour l'auto-hébergement n'a encore été publié. L'app peut déjà utiliser une adresse à toi, mais il n'y a pas encore de guide d'installation ici.
Tu prévois Hangar pour une entreprise et tu as besoin de ton propre serveur ? Écris-nous et nous étudierons ton cas.