Dokumentation

Hangar nach der Installation

Alles, was du für den Alltag mit Hangar brauchst: vom ersten Agenten bis zu den Dateien, in denen Hangar deine Einstellungen ablegt.

Erste Schritte

  1. Installieren. Lade Hangar-Setup.exe herunter und führe die Datei aus. Hangar installiert sich nur für deinen Benutzer, ohne Administratorrechte.
  2. 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.
  3. 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.
  4. 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.

Überall in Hangar
TastenWirkung
Strg+Umschalt+PSchnellzugriff: Sessions, Programme, Dateien, letzte Commits, Einstellungen und jeden Menübefehl finden
Strg+Umschalt+SDie Ausgabe aller Sessions durchsuchen
Strg+Umschalt+MAlle Sessions als Live-Kacheln zeigen
Strg+Umschalt+HStartansicht zeigen; die Sessions laufen weiter
Strg+Umschalt+TNeue Session mit dem zuletzt verwendeten Programm
Strg+Umschalt+WSession schließen
Strg+TabNächste Session
Strg+Umschalt+TabVorherige Session
Strg+Umschalt+AZur nächsten Session, die auf dich wartet
Strg+Umschalt+NSchnelle Notiz
Strg+Umschalt+DÄnderungen im Ordner der Session ein- oder ausblenden
Strg+Umschalt+FIm Verlauf des Terminals suchen
Strg+Umschalt+BSeitenleiste ein- oder ausklappen
Strg+,Einstellungen öffnen
Strg++Schrift größer
Strg+-Schrift kleiner
Strg+0Schriftgröße zurücksetzen
Im Terminal
TastenWirkung
Strg+CAuswahl kopieren; ohne Auswahl geht die Taste an das Programm (Abbrechen)
Strg+Umschalt+CAuswahl kopieren und markiert lassen
Strg+VEinfügen; liegt ein Bild in der Zwischenablage, fügt Hangar den Pfad der gespeicherten Bilddatei ein
Umschalt+EnterNeue Zeile im Prompt eines Agenten, ohne ihn zu senden
Strg+Umschalt+LeertasteGedrückt halten zum Diktieren; die Sprache wird auf deinem Rechner erkannt
In der Suche im Verlauf
TastenWirkung
EnterNächster Treffer
Umschalt+EnterVorheriger Treffer
EscSuche schließen
Notizen, Seitenleiste und Senden an mehrere
TastenWirkung
F6 / Umschalt+F6Bei offenen Notizen den Fokus zwischen Terminal, Notizliste und Editor wechseln
F2Notiz umbenennen
Alt+↑ / Alt+↓Markierte Session in der Seitenleiste nach oben oder unten verschieben
Strg+EnterNachricht 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.

Felder eines Profils
FeldBedeutung
idPflicht. Eindeutig, ohne Leerzeichen. Zwei IDs, die sich nur in der Groß- und Kleinschreibung unterscheiden, lehnt Hangar ab.
namePflicht. Anzeigename in der Seitenleiste.
commandPflicht. Programmname aus dem PATH oder vollständiger Pfad. Keine Shell-Syntax: Hangar startet das Programm direkt.
argsArgumente als Liste, zum Beispiel ["--model", "opus"].
cwdFester Arbeitsordner. Ohne dieses Feld startet das Programm in dem Ordner, den du auswählst.
iconEin oder zwei Zeichen für das Symbol in der Seitenleiste.
[profile.env]Umgebungsvariablen als eigene Tabelle. Hier keine Geheimnisse eintragen.
secret_envNamen von Variablen, deren Werte Hangar in der Windows-Anmeldeinformationsverwaltung aufbewahrt, zum Beispiel ["GITHUB_TOKEN"].
resume_argsArgumente zum Fortsetzen der letzten Unterhaltung. Sie ersetzen args, statt angehängt zu werden.
version_argsArgumente für die Versionsabfrage, Standard ["--version"]; [] heißt: das Programm nie für die Version starten.
latest, packages, self_update, update_hintWo 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.

Speicherorte
OrtInhalt
%APPDATA%\com.feoren.hangar\profiles.tomlDeine Profile
%APPDATA%\com.feoren.hangar\HANGAR.mdDeine Anweisungen für alle Agenten
%APPDATA%\com.feoren.hangar\account.jsonGewä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%\HangarDas Programm selbst
.hangar\notes\Geteilte Notizen, verschlüsselt, im Repository
Windows-AnmeldeinformationsverwaltungGeheime 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.

Kontakt für Teams