Erste Schritte
- Installieren. Lade
Hangar-Setup.exeherunter und führe die Datei aus. Hangar installiert sich nur für deinen Benutzer, ohne Administratorrechte. - Agent starten. Wähle unter „Neue Session“ einen Projektordner, dann Privat oder Team, und klicke einen Agenten an. Hangar listet jeden Agenten, den es auf deinem Rechner findet, mit seiner Version; unter Team nur die, die als Team-Session laufen können.
- Team dazuholen (optional). Klicke unten in der Seitenleiste auf „Anmelden“, bestätige den Code im Browser und verbinde dann das Projekt. Wer demselben Projekt beitritt, sieht die anderen im Team-Fenster.
- Profilbild (optional). Dein Profilbild aus dem Hangar-Konto erscheint in der Seitenleiste. Du lädst es unter Konto › Einstellungen auf dieser Website hoch.
Hangar herunterladen Unterstützte Agenten
Zeigt Windows beim Installieren eine SmartScreen-Warnung, wähle „Weitere Informationen“ und dann „Trotzdem ausführen“. Das Installationsprogramm ist noch nicht mit einem Code-Signing-Zertifikat signiert. Updates innerhalb von Hangar sind immer signiert und werden geprüft.
Voraussetzungen: Windows 10 ab Version 1809 oder Windows 11 (x64). Die Agenten installierst du selbst, mit deinen eigenen Konten. Git brauchst du für Team-Sessions (Worktrees), die Änderungsübersicht, Commits und geteilte Notizen.
Tastenkürzel
Hangar fängt nur Kombinationen ab, die Shells und Agenten nicht brauchen. Die Gegenstücke ohne Umschalt bleiben beim Programm im Terminal: Strg+B, Strg+F oder Strg+P erreichen weiter deine Shell oder deinen Agenten.
| Tasten | Wirkung |
|---|---|
| Strg+Umschalt+P | Schnellzugriff: Sessions, Programme, Dateien, letzte Commits, Einstellungen und jeden Menübefehl finden |
| Strg+Umschalt+S | Die Ausgabe aller Sessions durchsuchen |
| Strg+Umschalt+M | Alle Sessions als Live-Kacheln zeigen |
| Strg+Umschalt+H | Startansicht zeigen; die Sessions laufen weiter |
| Strg+Umschalt+T | Neue Session mit dem zuletzt verwendeten Programm |
| Strg+Umschalt+W | Session schließen |
| Strg+Tab | Nächste Session |
| Strg+Umschalt+Tab | Vorherige Session |
| Strg+Umschalt+A | Zur nächsten Session, die auf dich wartet |
| Strg+Umschalt+N | Schnelle Notiz |
| Strg+Umschalt+D | Änderungen im Ordner der Session ein- oder ausblenden |
| Strg+Umschalt+F | Im Verlauf des Terminals suchen |
| Strg+Umschalt+B | Seitenleiste ein- oder ausklappen |
| Strg+, | Einstellungen öffnen |
| Strg++ | Schrift größer |
| Strg+- | Schrift kleiner |
| Strg+0 | Schriftgröße zurücksetzen |
| Tasten | Wirkung |
|---|---|
| Strg+C | Auswahl kopieren; ohne Auswahl geht die Taste an das Programm (Abbrechen) |
| Strg+Umschalt+C | Auswahl kopieren und markiert lassen |
| Strg+V | Einfügen; liegt ein Bild in der Zwischenablage, fügt Hangar den Pfad der gespeicherten Bilddatei ein |
| Umschalt+Enter | Neue Zeile im Prompt eines Agenten, ohne ihn zu senden |
| Strg+Umschalt+Leertaste | Gedrückt halten zum Diktieren; die Sprache wird auf deinem Rechner erkannt |
| Tasten | Wirkung |
|---|---|
| Enter | Nächster Treffer |
| Umschalt+Enter | Vorheriger Treffer |
| Esc | Suche schließen |
| Tasten | Wirkung |
|---|---|
| F6 / Umschalt+F6 | Bei offenen Notizen den Fokus zwischen Terminal, Notizliste und Editor wechseln |
| F2 | Notiz umbenennen |
| Alt+↑ / Alt+↓ | Markierte Session in der Seitenleiste nach oben oder unten verschieben |
| Strg+Enter | Nachricht an mehrere Sessions senden |
Profile in profiles.toml
Eigene Terminals und Agenten stehen in profiles.toml im Konfigurationsordner, unter Windows %APPDATA%\com.feoren.hangar\profiles.toml. Fehlt die Datei, legt Hangar sie beim Start aus einer kommentierten Vorlage an, mit PowerShell 7, Windows PowerShell und der Eingabeaufforderung.
Am schnellsten öffnest du die Datei in den Einstellungen unter Terminals & Agenten › Profildatei öffnen.
Agenten aus dem Katalog brauchen kein Profil, Hangar kennt sie von selbst. Willst du einen davon anders starten, lege ein Profil mit derselben id an: Es ersetzt Name, Symbol, Befehl, Argumente und Position des Katalogeintrags; Projektseite und Installationsbefehl bleiben aus dem Katalog.
| Feld | Bedeutung |
|---|---|
id | Pflicht. Eindeutig, ohne Leerzeichen. Zwei IDs, die sich nur in der Groß- und Kleinschreibung unterscheiden, lehnt Hangar ab. |
name | Pflicht. Anzeigename in der Seitenleiste. |
command | Pflicht. Programmname aus dem PATH oder vollständiger Pfad. Keine Shell-Syntax: Hangar startet das Programm direkt. |
args | Argumente als Liste, zum Beispiel ["--model", "opus"]. |
cwd | Fester Arbeitsordner. Ohne dieses Feld startet das Programm in dem Ordner, den du auswählst. |
icon | Ein oder zwei Zeichen für das Symbol in der Seitenleiste. |
[profile.env] | Umgebungsvariablen als eigene Tabelle. Hier keine Geheimnisse eintragen. |
secret_env | Namen von Variablen, deren Werte Hangar in der Windows-Anmeldeinformationsverwaltung aufbewahrt, zum Beispiel ["GITHUB_TOKEN"]. |
resume_args | Argumente zum Fortsetzen der letzten Unterhaltung. Sie ersetzen args, statt angehängt zu werden. |
version_args | Argumente für die Versionsabfrage, Standard ["--version"]; [] heißt: das Programm nie für die Version starten. |
latest, packages, self_update, update_hint | Wo neue Versionen erscheinen und wie Hangar das Programm mit einem Klick aktualisiert. Die kommentierte Vorlage in der Datei erklärt jedes Feld. |
Beispiel
Das erste Profil startet Claude Code aus dem Katalog mit einem anderen Modell. Das zweite ist eine eigene PowerShell mit festem Arbeitsordner, einer normalen und einer geheimen Variablen.
[[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"
Geheime Variablen
Die Werte aus secret_env stehen nie in der Datei. Du gibst sie in den Einstellungen ein, dort, wo du das Profil bearbeitest. Hangar legt sie in der Windows-Anmeldeinformationsverwaltung unter dem Dienst hangar ab und setzt sie erst beim Start einer Session in deren Umgebung. Eine Variable darf nicht gleichzeitig in [profile.env] und in secret_env stehen.
Nach dem Speichern lädt Hangar die Datei neu, sobald du zu seinem Fenster zurückkehrst, oder du wählst „Profile neu laden“. Einen Fehler zeigt Hangar mit Zeile und Spalte; laufende Sessions bleiben, wie sie sind.
Benachrichtigungen bei wartenden Agenten
Die Seitenleiste zeigt auf einen Blick, welcher Agent arbeitet, welcher fertig ist und welcher auf dich wartet. Alles Weitere stellst du in den Einstellungen unter Aufmerksamkeit ein.
- Wartende Sessions hervorheben: Eine Session pulsiert sanft, wenn ein Agent fertig ist oder auf dich wartet, während du woanders hinschaust. Ab wie vielen Sekunden Ruhe der Hinweis erscheint, legst du selbst fest.
- Farben und Pulsieren: Arbeitet, Fertig, Fragt dich und Pause bekommen jeweils eigene Farbe, Pulsstärke und Pulsdauer, mit Vorschau.
- Ton: ein leiser Zweiklang, wenn eine Session wartet, die du gerade nicht siehst. Endet ein Programm mit einem Fehler, klingt er tiefer. Die Lautstärke ist einstellbar.
- Desktop-Benachrichtigung: nur, solange Hangar im Hintergrund ist. Ein Klick darauf öffnet die Session.
- Taskleiste blinken lassen: nur, solange Hangar nicht im Vordergrund ist. Das Blinken endet, sobald du zum Fenster wechselst.
- Zähler an der Taskleiste: ein kleines Symbol auf der Schaltfläche zeigt, wie viele Sessions warten, von 1 bis 9 und darüber 9+.
- Push aufs Handy: über ntfy oder Pushover, wenn eine Session auf dich wartet. Wähle bei ntfy ein schwer zu erratendes Thema, denn wer es kennt, liest mit.
- Ruhezeiten: In den Stunden, die du festlegst, gibt es keinen Ton, keine Benachrichtigung, keinen Push aufs Handy und kein Blinken der Taskleiste. Farben und die Zahl wartender Sessions bleiben.
- Im Infobereich weiterlaufen: Schließt du das Fenster, laufen deine Sessions weiter, und das Symbol im Infobereich zeigt, wie viele warten. Beenden kannst du Hangar mit einem Rechtsklick auf das Symbol.
Mit Strg+Umschalt+A springst du direkt zur nächsten wartenden Session.
Team-Sessions und Worktrees
Unter „Neue Session“ wählst du Privat oder Team. Eine private Session läuft direkt in deinem Ordner, nur für dich. Eine Team-Session bekommt einen eigenen Git-Worktree und ist für dein Team sichtbar, so ändern mehrere Agenten dasselbe Projekt gleichzeitig, ohne sich gegenseitig die Dateien unter den Füßen wegzuziehen.
Hangar legt für jede Team-Session einen Branch hangar/… vom aktuellen Stand an. Will ein Agent eine Datei bearbeiten, an der eine andere Session arbeitet, hält Hangar ihn an und fragt dich; „Immer“ oder „Nie“ für eine Datei oder einen Ordner merkt sich Hangar je Projekt. Als Team-Session laufen Claude Code, Codex CLI, OpenCode und Pi.
Die Worktrees liegen im App-Datenordner unter %LOCALAPPDATA%\com.feoren.hangar\worktrees\, nicht neben deinem Repository. So bleiben Repository und synchronisierte Ordner sauber.
Startet ein Agent in einem frischen Worktree, prüft er zuerst, ob es neue Commits im Upstream gibt, und fragt, bevor er sie holt. Das lässt sich in den Einstellungen unter Terminals & Agenten abschalten.
Endet eine Team-Session, entfernt Hangar ihren Worktree wieder, außer er enthält noch Änderungen oder ignorierte Dateien wie Build-Ausgaben oder eine andere Session arbeitet noch darin. Hat der Branch Commits, die noch nicht zusammengeführt sind, bleibt er stehen. Hangar erzwingt dabei nie etwas.
Dafür muss Git installiert sein und der Ordner in einem Git-Repository liegen. Auf Netzwerkfreigaben führt Hangar kein Git aus, und die Rückfrage vor Änderungen gilt nicht in WSL.
Notizen
Notizen gehören zum Projekt einer Session oder in den Bereich Allgemein. Sie sind echte Markdown-Dateien, die du auch im Explorer öffnen kannst.
- Strg+Umschalt+N startet von überall eine schnelle Notiz.
- Markierten Text aus dem Terminal schickst du direkt in eine Notiz, und umgekehrt eine Notiz an eine Session. Dort wird sie ohne Enter eingefügt, damit du sie vorher prüfen kannst.
- Gelöschte Notizen landen in „Zuletzt gelöscht“ und lassen sich von dort wiederherstellen.
- Oben im Notizbereich wechselst du zwischen Privat und Geteilt. So bleiben deine eigenen Notizen von denen des Teams getrennt.
Geteilte, verschlüsselte Notizen
Schaltest du geteilte Notizen für ein Projekt ein, verschlüsselt Hangar sie und legt sie im Ordner .hangar\notes\ des Repositorys ab. Sie wandern mit deinen Commits. Lesen kann sie jeder, der das Repository und den Code hat. Entschlüsselter Text landet nie auf der Festplatte, und Hangar committet nie selbst.
Beim Einschalten zeigt Hangar einmal einen Wiederherstellungscode für Notizen. Bewahre ihn gut auf: Ohne ihn sind die Notizen endgültig verloren, wenn dieser Rechner seinen Schlüssel verliert. Mit dem Code öffnest du sie auch auf einem anderen Klon.
Eine Anweisungsdatei für alle Agenten
HANGAR.md liegt im Konfigurationsordner neben profiles.toml und funktioniert wie AGENTS.md oder CLAUDE.md, nur ohne eine Datei in deinem Repository. Hangar gibt den Inhalt jedem Agenten mit, der zusätzliche Anweisungen annimmt: Claude Code, Codex CLI und Aider. Standardmäßig ist das eingeschaltet; die Vorlage ist leer und sendet nichts, bis du hineinschreibst.
Die Datei öffnest du in den Einstellungen unter Terminals & Agenten › HANGAR.md öffnen. Dort schaltest du auch „HANGAR.md für jeden Agenten verwenden“ ein oder aus. Schreib keine Geheimnisse hinein: Der Text steht in der Befehlszeile der Agenten.
Speicherorte
Hangar legt Einstellungen in deinem Benutzerprofil ab, unter Windows in %APPDATA% und %LOCALAPPDATA%. Nur geteilte Notizen liegen im Projekt.
| Ort | Inhalt |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Deine Profile |
%APPDATA%\com.feoren.hangar\HANGAR.md | Deine Anweisungen für alle Agenten |
%APPDATA%\com.feoren.hangar\account.json | Gewählter Server und die Server, bei denen du angemeldet bist; keine Tokens |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Offene Sessions und ihr Verlauf, damit Hangar sie nach einem Neustart wiederherstellt |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Private Notizen als .md-Dateien, je Projektordner und unter general; gelöschte in .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktrees deiner Sessions |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Eingefügte Bildschirmfotos; Hangar löscht sie nach einer Woche |
%LOCALAPPDATA%\Hangar | Das Programm selbst |
.hangar\notes\ | Geteilte Notizen, verschlüsselt, im Repository |
| Windows-Anmeldeinformationsverwaltung | Geheime Profilvariablen, deine Anmeldung und die Schlüssel für Team und geteilte Notizen |
Eigener Team-Server
Für Teams verbindet sich Hangar standardmäßig mit dem offiziellen Dienst unter https://hangar.feoren.com/api/v1. Ohne Anmeldung funktioniert alles außer dem Team-Fenster.
Betreibt dein Team einen eigenen Hangar-Server, trägst du dessen Adresse in den Einstellungen unter Konto › Serveradresse (eigener Server) ein und klickst auf Übernehmen. Leer gelassen gilt wieder der offizielle Dienst.
Die Adresse ist die API-Basis des Servers, zum Beispiel https://team.example.com/api/v1. Sie muss mit https:// beginnen; reines http erlaubt Hangar nur für localhost, 127.0.0.1 und [::1]. Benutzername, Passwort, Abfrage und Fragment sind nicht erlaubt. Hangar speichert die Adresse in account.json; Anmeldungen bei anderen Servern bleiben auf dem Gerät erhalten.
Ein solcher Server muss dieselbe Schnittstelle sprechen wie der offizielle Dienst: Anmeldung über den OAuth-Device-Flow, Konto und Projekte, dazu Tickets für das Relay, über das die Team-Daten per WebSocket laufen. Die Datentypen des Protokolls und die Verschlüsselung liegen offen im App-Repository, in den Crates hangar-team-protocol und hangar-team-crypto unter MIT-Lizenz.
Alles, was mit dem Team geteilt wird, verschlüsselt Hangar auf deinem Gerät. Der Server speichert und verteilt es, kann es aber nicht lesen. Neue Geräte kommen erst dazu, wenn jemand eine Sicherheitsnummer vergleicht und bestätigt.
Stand heute: Eine fertige Server-Software zum Selbstbetrieb ist noch nicht veröffentlicht. Die App kann eine eigene Adresse zwar schon verwenden, eine Installationsanleitung gibt es hier aber noch nicht.
Du planst Hangar für eine Firma und brauchst einen eigenen Server? Schreib uns, dann besprechen wir deinen Fall.