Dokumentation

Relay Dokumentation

Alles was du brauchst, um Relay optimal zu nutzen.

Installation

Relay kann als DMG oder via Homebrew installiert werden.

Direkt-Download

Universal Binary für Apple Silicon und Intel.

Download-Seite

Homebrew

brew install --cask relay

Voraussetzungen: macOS 15 Sequoia+, Universal Binary (Apple Silicon & Intel)

Erste Schritte

Nach der Installation bist du in drei Schritten startklar.

Theme wählen

Öffne die Settings und wähle eines der 19 Themes. Das gesamte visuelle System ändert sich sofort.

Prompt-Stil einstellen

Wähle einen der 9 Prompt-Stile. Die Änderung wird live in der aktuellen Shell angewendet.

Workspace einrichten

Erstelle Workspaces für verschiedene Projekte. Jeder Workspace hat eigene Panes, Themes und Layouts.

Tastenkürzel

Die wichtigsten Keyboard Shortcuts für schnelles Arbeiten.

Kürzel	Aktion
`⌘K`	Command-Palette öffnen
`⌘D`	Pane horizontal splitten
`⌘⇧D`	Pane vertikal splitten
`⌘W`	Aktive Pane schließen
`⌘⌥]`	Nächste Pane fokussieren
`⌘⌥[`	Vorherige Pane fokussieren
`⌘1`	Aktive Pane → Terminal
`⌘2`	Aktive Pane → Editor
`⌘3`	Aktive Pane → Browser
`⌘4`	Aktive Pane → AI-Chat
`⌘5`	Aktive Pane → ScratchPad
`⌘I`	Infopanel ein/aus
`⌘⌥A`	Global Ask — AI aus jeder Pane fragen
`⌘⇧↑`	Zum vorherigen Command-Block springen
`⌘⇧↓`	Zum nächsten Command-Block springen
`⌘+ / ⌘−`	Schrift vergrößern / verkleinern
`⌘0`	Schrift auf Standardgröße zurücksetzen

Theme-System

Relays Theme-System besteht aus drei Ebenen, die zusammen das gesamte Erscheinungsbild der App steuern.

Drei-Ebenen-Architektur

Jedes Theme setzt sich aus drei unabhängigen Ebenen zusammen, die zusammenwirken.

Layer 1

AppTheme

Steuert die App-Chrome: Hintergründe, Borders, Akzentfarbe, Glassmorphism, Glow-Effekte.

Layer 2

TerminalTheme

Definiert die ANSI-Farbpalette: 8 Normal- + 8 Bright-Farben, Cursor, Selection, Hintergrund.

Layer 3

PromptStyle

Bestimmt das Prompt-Layout: Symbole, Farben, Powerline-Segmente, Git-Info-Anzeige.

Glass Themes

Sechs moderne Themes mit Glassmorphism, Glow-Effekten und eigener Typografie.

Relay Dark Midnight Aurora Obsidian Sunset Arctic

Retro Themes

Acht historische Terminals (1973–1989) als vollständige visuelle Identitäten mit Scanlines und Perioden-Fonts.

BBC Micro Apple II Amstrad CPC VT100 Amber IBM 3270 Xerox Alto Game Boy ZX Spectrum Retro DOS C64

Design-Tokens

Jedes Theme definiert 93 Design-Tokens, die das gesamte Erscheinungsbild steuern.

bg · bgElevated · bgTerm · bgTabBar
accent · accentGlow · accentDim
border · borderHi
fg · fgSecond · fgTertiary
glassTint · glassBorder · glassHighlight
scanlines · suggestedFontName · suggestedPromptStyle

Hell/Dunkel-Modus

Relay unterstützt ein helles und ein dunkles Theme mit automatischem Wechsel basierend auf der macOS-Systemeinstellung.

Farb-Schema

Modus	Beschreibung
Dunkel	Verwendet das konfigurierte dunkle Theme (Standard: Relay Dark).
Hell	Verwendet das konfigurierte helle Theme (Standard: Relay Light).
System	Wechselt automatisch zwischen Hell und Dunkel wenn macOS den Modus ändert.

Der Modus wird in den Einstellungen unter Erscheinungsbild → Farb-Schema konfiguriert. Bei System wird die macOS-Einstellung beobachtet und das Theme sofort gewechselt.

Pane-Layouts

Neun Layout-Presets ermöglichen es, einen Workspace in bis zu 4 Panes aufzuteilen. Layouts werden pro Workspace gespeichert.

Layout	Panes	Beschreibung
`Single`	1	Standard — ein einzelner Pane
`2 Side`	2	Zwei Panes nebeneinander
`2 Stack`	2	Zwei Panes übereinander
`3 Side`	3	Drei gleich breite Panes nebeneinander
`4 Side`	4	Vier gleich breite Panes nebeneinander
`1+2`	3	Ein großer Pane links, zwei kleine rechts
`1+3`	4	Ein großer Pane links, drei kleine rechts
`2×2`	4	Vier Panes im 2×2-Raster
`Focus`	2	Ein fokussierter Pane, ein gedimmter Sekundär-Pane

Layouts werden automatisch angepasst: Beim Hinzufügen eines Panes wird das Layout upgraded, beim Entfernen downgraded.

Prompt-Stile

9 Prompt-Stile — 5 Built-in im Relay-managed-Modus (Relay Compact, Robbyrussell, Minimal, Lambda, Powerblocks), 4 externe im „Your ~/.zshrc"-Modus (Agnoster, Spaceship, Powerlevel10k, Starship).

Stil	Herkunft	Powerline
Relay Compact	Built-in	—
Robbyrussell	Built-in	—
Minimal	Built-in	—
Lambda	Built-in	—
Powerblocks	Built-in	✓
Agnoster	Extern (Rust)	✓
Spaceship	Extern (Rust)	—
Powerlevel10k	Extern (Rust)	✓
Starship	Extern (Rust)	—

Powerline-Stile benötigen einen Nerd Font. Relay verwendet standardmäßig JetBrains Mono Nerd Font.

Workspaces

Workspaces sind isolierte Arbeitsumgebungen mit eigenem State. Jeder Workspace speichert:

Eigenes Theme und Terminal-Farbpalette
Eigenes Pane-Layout (Single, 2×2, Focus, etc.)
Eigene Panes mit individuellen Shells
Persistenz zwischen Sessions (Tabs, CWD, Layout)
Broadcast-Modus: Eingabe an mehrere Panes gleichzeitig
Optionaler eigener Shell-Pfad pro Workspace

Project Memory

Relay speichert Kontext pro Projekt-Verzeichnis persistent auf Disk. Commands, Verzeichnisse und Nutzungshäufigkeit bleiben über Sessions hinweg erhalten.

Commands werden pro Projekt dedupliziert gespeichert — mit Nutzungshäufigkeit und letztem Exit-Code
Besuchte Verzeichnisse werden mit Besuchszähler und Zeitstempel erfasst
Aufbewahrung konfigurierbar: 7 Tage, 30 Tage oder unbegrenzt
Die häufigsten Commands erscheinen in der Sidebar unter 'Project History'

Speicherort

Pro Projekt wird eine JSON-Datei unter dem konfigurierten Pfad gespeichert (Standard: ~/.config/relay/memory/). Max. 500 Commands und 200 Verzeichnisse pro Projekt.

~/.config/relay/memory/<hash>.json

Beim App-Start werden alte Einträge basierend auf der Retention-Einstellung automatisch bereinigt. Leere Projektdateien werden entfernt.

Shell-Integration

Relay integriert sich tief in die Shell, um Befehle, Exit-Codes und Arbeitsverzeichnisse zu tracken. Die Integration wird bei jedem Start automatisch installiert.

Unterstützte Shells

Shell	Integration	Hooks
`zsh`	ZDOTDIR → `~/.config/relay/`	precmd / preexec
`bash`	--rcfile `~/.config/relay/.bashrc`	PROMPT_COMMAND + DEBUG trap
`fish`	-C source `~/.config/relay/fish/`	fish_preexec / fish_postexec

OSC-Sequenzen

Relay nutzt Operating System Command (OSC) Sequenzen für die Kommunikation zwischen Shell und App.

OSC	Funktion
`OSC 133;A`	Prompt-Start
`OSC 133;B`	Befehl-Start (Nutzer tippt)
`OSC 133;C`	Ausgabe-Start (Befehl abgeschickt)
`OSC 133;D;exit`	Befehl beendet mit Exit-Code
`OSC 7`	Aktuelles Arbeitsverzeichnis
`OSC 1337`	iTerm2-Kompatibilität (CurrentDir)
`OSC 9999;ask`	Relay-Befehle (ask, save)

Shell-Modi

Relay bietet zwei Modi für die Shell-Konfiguration.

Relay Prompt

Isolierte Shell-Konfiguration. Relay verwaltet den Prompt vollständig. Ideal für konsistentes Verhalten.

User .zshrc

Lädt die eigene ~/.zshrc mit Relay-Hooks. Kompatibel mit oh-my-zsh, p10k und Starship.

Per-Pane Shell-Modus

Jeder Pane kann individuell zwischen Relay-Prompt und User-zshrc umgeschaltet werden — direkt im Pane-Header, ohne die Einstellungen zu öffnen.

Ein Badge im Pane-Header zeigt den aktiven Modus: 'relay' (Terminal-Icon) oder 'zshrc' (Person-Icon)
Ein Klick auf das Badge terminiert die aktuelle Shell und startet sie sofort mit dem anderen Modus neu
Jeder Pane behält seinen eigenen Modus — unabhängig von anderen Panes und der globalen Einstellung

Info-Panel

Das Info-Panel (⌘I) zeigt kontextbezogene Informationen zum aktiven Workspace und Pane.

Project Memory

Zeigt den aktuellen Projektkontext: Pfad, Git-Branch, Runtime. Persistent zwischen Sessions.

Recent Commands

Die letzten 5 Befehle mit Exit-Code-Badge (grün/rot/orange) und Zeitstempel.

Favorites

Favorisierte Befehle und Verzeichnisse. Per Stern-Icon markierbar, persistent gespeichert.

Working Directories

Verlauf der besuchten Verzeichnisse. Klick navigiert sofort dorthin.

Offene Ports

Relay erkennt automatisch offene Ports und die zugehörigen Prozesse auf dem System.

Automatische Erkennung aller lauschenden TCP-Ports
Anzeige von Port, Prozessname und PID
Process-Tree-Kill per Klick (getpgid + SIGKILL)
Sudo-Fallback bei fehlenden Rechten (kopiert Befehl in Clipboard)

VPN-Erkennung

Relay erkennt aktive VPN-Tunnel (OpenVPN, WireGuard, Tailscale, NordVPN, Mullvad, Cisco AnyConnect und 14+ weitere Provider) und zeigt Interface, IP und Provider im Info-Panel.

AI Agent

Der integrierte AI Agent beantwortet Fragen direkt im Terminal. Er kennt den Shell-Kontext (letzte Befehle, CWD, Ausgaben) und kann gezielt helfen.

Verwendung

relay ask "Was macht dieser Befehl?"

Provider

Provider	Modelle
OpenAI	gpt-4o-mini, gpt-4, gpt-4o
Anthropic	claude-haiku-4-5, claude-sonnet, claude-opus

Slash-Commands

Befehl	Beschreibung
`/help`	Hilfe anzeigen
`/save`	Gespräch speichern
`/clear`	Verlauf löschen
`/model`	Modell wechseln
`/copy`	Letzte Antwort kopieren
`/context`	Shell-Kontext anzeigen
`/run`	Befehl ausführen
`/tokens`	Token-Verbrauch anzeigen
`/exit`	Agent beenden

Automatisches Error-Explain

Wenn ein Befehl mit einem Fehler-Exit-Code endet, bietet Relay an, den Fehler automatisch vom AI-Agenten erklären zu lassen.

Fehlgeschlagene Commands werden in der Sidebar mit einem roten Punkt und einem 'Explain?'-Badge markiert
Ein Klick auf 'Explain?' sendet 'relay explain' an die Shell — der AI-Agent erklärt den letzten Befehl
Erfordert einen konfigurierten AI-Provider (Anthropic oder OpenAI) in den Einstellungen

Semantic Colorizer

Relay coloriert Terminal-Ausgaben automatisch: Fehler, Warnungen, URLs, Pfade und Zahlen erhalten kontextbezogene Farben — ohne die existierende ANSI-Ausgabe zu überschreiben.

Muster	Farbe	Beispiel
Fehler	Rot (fett)	`error, fatal, exception`
Warnungen	Gelb	`warning, deprecated`
Erfolg	Grün	`OK, Done, PASSED, ✓`
URLs	Blau (unterstrichen)	`https://...`
Pfade	Cyan	`/usr/local/bin`
IPv4	Gelb	`192.168.1.1`
Zahlen + Einheiten	Magenta	`340ms, 18.4MB`

Command Blocks

Jeder Befehl und seine Ausgabe wird als eigenständiger Block mit visuellen Trennlinien dargestellt. Rechtsklick auf einen Befehl unter RECENT für Block-Aktionen.

│

Visuelle Trennlinien

Dezente Gradient-Linien zwischen Befehlen machen das Terminal auf einen Blick übersichtlich.

⧉

Block-Aktionen

Rechtsklick unter RECENT → Output kopieren, erneut ausführen, zum Block scrollen, Favorit hinzufügen.

⌘⇧↑

Block-Navigation

⌘⇧↑ / ⌘⇧↓ zum Springen zwischen Command-Blocks.

Inline Autocomplete

IDE-artiges Dropdown das beim Tippen erscheint — mit Subcommands, Flags und Beschreibungen.

git commit --message, --amend, --all, --no-edit...

Eingebaute Completion-Specs für:

git docker npm cargo brew

Navigieren mit ↑/↓, akzeptieren mit Tab, schließen mit Esc.

Inline-Bilder

Bilder direkt im Terminal anzeigen — über das Kitty Graphics Protocol.

relay imgcat ~/Desktop/photo.png

Unterstützt PNG, JPEG, GIF. Nutzt das Kitty-Protokoll mit chunked Base64-Übertragung für große Dateien.

Automatischer Profil-Wechsel

Das Theme wechselt automatisch basierend auf dem Kontext — visuelles Sicherheitsnetz für gefährliche Umgebungen.

🔴

SSH

SSH-Verbindungen wechseln zu einem Warn-Theme (z.B. Obsidian). Konfigurierbar pro Host-Pattern.

📁

Verzeichnis-Regeln

Theme wechselt beim Betreten bestimmter Verzeichnisse. Matching mit Regex-Patterns.

Klickbare Pfade & URLs

Dateipfade und URLs in der Terminal-Ausgabe sind klickbar. ⌘+Klick zum Öffnen — Pfade öffnen im Finder, URLs im Browser. Nutzt den OSC 8 Hyperlink-Standard.

⌘+Click → /usr/local/bin/node → opens in Finder

Regex-Trigger

Automatische Aktionen wenn Terminal-Output einem Pattern entspricht. Konfigurierbar unter Einstellungen → Appearance → Regex Triggers.

🔔

Benachrichtigungen

macOS-Benachrichtigung wenn Output matcht (z.B. 'BUILD SUCCEEDED').

🔊

Sound

Sound abspielen bei Pattern-Match (z.B. 'BUILD FAILED').

Parametrisierte Snippets

Wiederverwendbare Befehlsvorlagen mit Platzhalter-Parametern. Doppelklick in der Sidebar zum Ausführen.

deploy {{service}} to {{env}}

Beim Ausführen erscheint ein Formular für jeden Platzhalter. Live-Vorschau zeigt den aufgelösten Befehl vor dem Ausführen.

Session Blueprints

Workspace-Layouts als wiederverwendbare Templates speichern. Jeder Blueprint definiert Panes, Startverzeichnisse und Auto-Start-Befehle.

Konfigurierbar unter Einstellungen → Integration → Session Blueprints. Starten über die Sidebar-Sektion BLUEPRINTS.

Pane-Farbmarkierung

Farben per Rechtsklick auf den Pane-Header zuweisen. 7 Preset-Farben (Grün, Rot, Gelb, Blau, Lila, Orange, Cyan) zur visuellen Unterscheidung von Umgebungen.

CI/CD Pipeline Monitor

GitHub Actions direkt in Relay überwachen. Nach git push erscheint der Pipeline-Status live in der Sidebar.

⚡

Auto-Erkennung

Erkennt git push aus jeder Shell (Relay, externes Terminal, IDE) über Filesystem-Überwachung.

📊

Live-Updates

Steps aktualisieren sich alle 5 Sekunden mit animierter Fortschrittsanzeige und pulsierenden Status-Dots.

📋

Job-Logs

Klick auf einen Step öffnet das Log direkt inline darunter. Logs mit einem Klick in die Zwischenablage kopieren.

Settings → CI/CD Pipeline → GitHub Token

Sidebar Cockpit

Workspaces, Pane-Topologie und Layout-Auswahl sind in der rechten Sidebar gebündelt. Kein Modal, kein Popover — alles bleibt in Sicht.

🟢

Workspaces-Sektion

Liste aller offenen Workspaces mit farbigem Dot, Pane-Anzahl (z.B. „4p“) und Activity-Indikator wenn ein Pane gerade einen Befehl ausführt. Klick aktiviert, Rechtsklick → Close.

🔲

Pane-Mini-Grid

Pro Pane: pulsierender Running-Indikator, aktueller oder letzter Befehl, Exit-Code-Badge (✓ / Fehlercode / ⌃C) und Shell-Mode-Toggle (Relay-Prompt ↔ ~/.zshrc). Drag-to-Swap zwischen Slots.

📐

Inline Layout-Picker

Header-Pille zeigt aktuelles Layout (z.B. „2×2 ▾“). Klick klappt 6 Topology-Thumbnails auf: Single, 2 Side, 2 Stack, 1+2, 2×2, Focus.

🔤

Workspace-Initialen

Eingeklappte linke Sidebar zeigt den Anfangsbuchstaben jedes Workspace als Badge — statt anonymer Dots. „bunni“ → „B“, „T1“ → „T“.

⌘P → Linke Sidebar ein/ausklappen

Inline Workflow

Eingaben dort, wo der Befehl entsteht. Snippets, Pipeline-Logs und Blueprints klappen direkt in der Sidebar auf — mit Live-Preview und Run-Button.

📝

Snippet-Inline-Form

Parametrische Snippets klappen mit Inline-Inputs auf. Live-resolved Preview zeigt den finalen Befehl. Run-Button ist disabled solange Parameter leer sind — keine zerschossenen Befehle.

📋

Pipeline-Step-Log inline

Klick auf einen CI/CD-Step expandiert dessen Log direkt darunter. Scrollbar, selektierbar, mit Kopieren-Button.

📁

Blueprint Folder-Picker

Pane-Verzeichnisse per nativen macOS-Dialog auswählen statt zu tippen. Pfade werden home-relativ gespeichert (~/projekt) für Cross-Machine-Portabilität.

Pipeline Step-Rings

CI/CD-Steps werden als animierte Progress-Ringe angezeigt — kein linearer Balken mehr. Status auf einen Blick erkennbar.

⏳

Running

Gelber Spinner-Ring (72% gefüllt) rotiert kontinuierlich. Linear, 1.2 Sekunden pro Umdrehung.

✓

Success

Voller grüner Ring mit Checkmark in der Mitte. Sofort erkennbar in der Step-Liste.

✗

Failed

Voller roter Ring mit X in der Mitte. Plus rote Step-Name-Farbe für zusätzliche Auffälligkeit.

Workspace-Verzeichnis-Inheritance

Wenn du einen Workspace mit einem spezifischen Pfad öffnest, landen alle neuen Splits im selben Projekt — nicht im Home-Verzeichnis.

📂

Split-Vererbung

⌘D und ⌘⇧D öffnen neue Panes im Workspace-Root-Pfad. Wenn du im Pane mit `cd` woanders hingehst, beeinflusst das nicht den nächsten Split.

🧩

Blueprint inheritance

Blueprints erben den Pfad ihres ersten Panes als Workspace-Root. Spätere Splits im Blueprint-Workspace landen ebenfalls dort.

🎯

Auto-Fit-Layout

Wenn ein Blueprint mehr Panes als das gewählte Layout hat (z.B. „single“ mit 4 BlueprintPanes), wird das Layout automatisch zum passenden upgraded (twoByTwo).

Code-Editor (v1.2)

Jede Terminal-Pane lässt sich per Rechtsklick → „Convert to editor" in einen Code-Editor verwandeln. Datei-Tree links, Editor mit Tabs rechts. Powered by CodeEditSourceEditor (Tree-sitter).

🔀

Pane-Konvertierung

Rechtsklick auf das Pane-Label → „Convert to editor". Zurück geht's via „Convert to terminal". Der Folder-Root ist der Git-Repo-Root des aktuellen cwd.

🎨

Tree-sitter Highlighting

Sprachen werden automatisch via Dateinamen-Endung erkannt. Unterstützt: Swift, TS/JS/TSX, Rust, Python, Go, Ruby, Java, Kotlin, C/C++, JSON, TOML, YAML, Markdown, Shell, CSS, HTML, SQL, Dockerfile und weitere.

📑

Multi-Tab + Cursor-Memory

Mehrere Dateien gleichzeitig geöffnet. Tab-Bar oben mit Dirty-Indikator. Cursor- und Scroll-Position bleibt pro Datei erhalten, auch wenn man zwischen Tabs wechselt.

🗂️

Datei-Tree mit Kontextmenü

Rechtsklick auf einen Eintrag: Reveal in Finder, Copy Path, New File, New Folder, Rename, Duplicate, Move to Trash. Eingabe-Sheets für Namen, Trash mit Bestätigung.

✨

Autocomplete

Word-Completion aus Buffer-Identifiern plus sprachspezifische Keyword-Listen (Swift, TS/JS, Rust, Python, Go, Ruby, Java, Kotlin, Bash, CSS). Auto-Trigger bei jedem getippten Buchstaben.

🎭

6 Editor-Themes

Relay Dark, Relay Light, Solarized Dark, Nord, Monokai, GitHub Light — alle mit authentischen Brand-Farben. Einstellbar in Settings → Code Editor → Theme.

Tastenkürzel

Taste	Aktion
`⌘S`	Aktive Datei speichern
`⌘W`	Aktiven Tab schließen
`⌘1`–`⌘9`	Direkt zu Tab N springen
`⌘F`	Find & Replace öffnen

Stack Detector (v1.2)

Sobald die aktive Terminal-Pane in einem Git-Repository ist, scannt Relay alle Manifest-Dateien und zeigt die erkannten Stacks in der STACK-Sektion der rechten Sidebar.

🔍

Repo-Scan via `git ls-files`

Nutzt `git ls-files --cached --others --exclude-standard` für die Datei-Liste — alle .gitignore-Regeln werden korrekt respektiert. Tool-Ordner wie `.github`, `.vscode`, `node_modules` werden zusätzlich gefiltert.

📦

Unterstützte Stacks

Node.js (package.json), Rust (Cargo.toml), Python (pyproject.toml/requirements.txt), Go (go.mod), Swift (Package.swift/xcodeproj), Ruby (Gemfile), Docker (Dockerfile/compose), Hugo, Jekyll, Zola, mdBook, Supabase.

🏷️

Framework-Erkennung

Bei Node.js werden Next.js, Nuxt, Astro, SvelteKit, Remix, Gatsby, Eleventy, Qwik, Solid, Vue, React, Angular, Tauri, Electron, Vite und weitere erkannt. Bei Python: FastAPI, Django, Flask, Streamlit, PyTorch.

🧩

Monorepo-Aware

Workspace-Marker (pnpm-workspace.yaml, turbo.json, nx.json, lerna.json, Cargo [workspace]) werden eigens behandelt. Sonst werden alle Subordner-Stacks als getrennte Karten gezeigt.

▶️

Klickbare Scripts

Jedes erkannte Script erscheint mit ▶-Button. Klick schreibt den Befehl direkt in die aktive Terminal-Pane — mit `cd <subdir>`-Prefix bei Multi-Stack-Repos.

Terminal-Suche

Inkrementelle Suche im aktiven Terminal-Buffer mit optionalem Regex-Modus. Die Match-Indikator-Pille zeigt sofort, ob es Treffer gibt.

Taste	Aktion
`⌘F`	Such-Bar öffnen / schließen
`⌘G`	Nächster Treffer
`⌘⇧G`	Voriger Treffer
`Esc`	Suche schließen

Regex-Toggle in der Bar — wechsle zwischen literaler Suche und vollem NSRegularExpression-Pattern
Eingabefeld färbt rot, wenn keine Treffer mehr im Buffer — kein Rätselraten
Funktioniert nicht im Alt-Screen-Modus (vim, less, tmux), weil dort die App selbst die Tastatur kontrolliert

Broadcast-Eingabe

Tippe einmal — jeder ausgewählte Pane bekommt die Eingabe parallel. Perfekt für Multi-Server-Operationen, Cluster-Wartung oder Vergleichstests in mehreren Containern.

📡

Aktivierung

Toggle in der Workspace-Sidebar — die BROADCAST-Sektion erscheint und listet alle Panes des Workspaces mit Checkbox.

✅

Pane-Auswahl

Per Checkbox wählst du, welche Panes mit-empfangen sollen. Beim Aktivieren sind alle Panes vorausgewählt; einzelne lassen sich abwählen.

🖥️

Typische Anwendungsfälle

SSH zu vier Servern, `apt update` einmal ausführen. Drei Docker-Container parallel inspizieren. Mehrere Branches gleichzeitig pullen.

VPN-Erkennung

Relay scannt alle `utun*`-Interfaces auf macOS und identifiziert den aktiven VPN-Provider anhand der Prozessliste. Die VPN-Sektion erscheint nur dann in der Sidebar, wenn tatsächlich ein Tunnel aktiv ist — kein Visual-Noise wenn nichts läuft.

Unterstützte Provider (14+)

OpenVPN, WireGuard, Tailscale, NordVPN, Mullvad, Cloudflare WARP, Cisco AnyConnect, ExpressVPN, ProtonVPN, Surfshark, PIA, Windscribe, Hotspot Shield, ZeroTier — alle werden über ihren Prozessnamen identifiziert.

Was angezeigt wird

Tunnel-Interface (utun0/utun1/…), zugewiesene lokale IP, Provider-Name mit Status-Badge.

Wann sichtbar

Nur wenn mindestens ein utun-Interface aktiv ist und der zugehörige Prozess läuft. Auto-Refresh bei cwd-Wechsel.

Polish & Atmosphäre

Kleine Details die den Unterschied machen — von Notifications für lange Befehle bis zum animierten Hintergrund.

🔔

Visual + Audible Bell

Wenn ein Programm `BEL` schickt (z.B. `printf '\a'` oder bei Tab-Completion-Konflikt), blinkt das Pane kurz weiß auf. Optional zusätzlich Systemton. Einstellbar pro Workspace.

⏱️

Long-Command-Notification

Befehle länger als N Sekunden (default 30s) lösen eine macOS-Notification aus, wenn sie fertig sind — auch wenn Relay im Hintergrund ist. Du musst nicht mehr ständig hinschauen.

🪝

Webhook-Notifications

Optional eine Webhook-URL eintragen (Slack, Discord, ntfy.sh, …). Lange Befehle werden zusätzlich an die URL geschickt — perfekt für Builds im Büro während du beim Mittagessen bist.

🌌

Aurora-Background

Animierter Mesh-Gradient mit vier farbigen Blobs hinter dem Window. 30 FPS via Canvas + drawingGroup() (GPU-beschleunigt). Farbe richtet sich nach dem aktiven App-Theme.

📺

CRT-Effekte

Retro-Themes bekommen Scanlines (Off/Light/Medium/Heavy einstellbar), eine subtile Vignette an den Rändern und Chromatic-Aberration-Farbfransen. Pure Retro-Vibes, performance-neutral.

🔄

Auto-Updates via Sparkle

Relay updated sich automatisch — neue Versionen erscheinen mit Changelog-Vorschau und Install-Button. Manuell prüfbar via Menü „Relay → Check for Updates".

Einstellungen

Relay organisiert alle Einstellungen in 11 Seiten. Alle Settings werden in UserDefaults gespeichert und sind sofort wirksam. Gruppen: Appearance (Look & Feel, Tastatur) · Environment (Shell, Benachrichtigungen) · Panes (Editor, Browser) · Power Tools (Memory, Integration, AI, Pipeline) · Account (Lizenz).

Seite 1: Erscheinungsbild

Theme, Farb-Schema, Font, Cursor, Transparenz und Semantic Highlighting — alles auf einer Seite.

Einstellung	Standard	Beschreibung
`colorSchemeEnabled`	false	Auto-Erscheinungsbild aktivieren (Hell/Dunkel/System)
`colorScheme`	dark	Modus: dark · light · auto (folgt macOS)
`appThemeID`	relay-dark	App-Theme (19 Themes: 11 Modern + 8 Retro)
`themeID`	dark-default	Terminal-Farbpalette (ANSI-Farben)
`promptStyleID`	robbyrussell	Prompt-Stil (9 Stile)
`fontSize`	13	Schriftgröße (8–32)
`fontName`	JetBrains Mono Nerd	Schriftart (Nerd Font empfohlen)
`backgroundOpacity`	0.7	Hintergrund-Transparenz
`semanticHighlighting`	true	Automatische Einfärbung von Fehlern, Pfaden, URLs
`cursorShape`	block	block · bar · underline
`cursorBlink`	true	Cursor-Blinken ein/aus
`cursorColorHex`	#4af09a	Cursor-Farbe (Hex)

Seite 2: Tastatur

Übersicht aller 20 Tastenkürzel — von ⌘T (neuer Tab) bis ⌘0 (Schrift zurücksetzen).

Seite 3: Shell & Umgebung

Shell-Programm, Login-Modus, Startup-Verzeichnis, ENV-Variablen und PATH-Erweiterungen.

Einstellung	Standard	Beschreibung
`shellPath`	$SHELL	Shell-Pfad (automatisch erkannt)
`shellLoginMode`	true	Login-Shell (-l Flag)
`shellArgs`	—	Zusätzliche Shell-Argumente beim Start
`useUserZshrc`	false	Eigene .zshrc verwenden
`optionAsMeta`	false	Option-Taste als Meta
`inheritSystemEnv`	true	System-Umgebung erben (Standard: aktiviert)
`pathExtensions`	—	PATH-Erweiterungen (werden am Anfang eingefügt)
`autoLoadDotenv`	false	Automatisches Laden von .env-Dateien im Arbeitsverzeichnis

Seite 4: Benachrichtigungen

Bell-Verhalten, Langzeit-Command-Benachrichtigungen und Webhook-Integration.

Einstellung	Standard	Beschreibung
`audibleBell`	false	System-Sound bei Terminal-Bell
`visualBell`	true	Kurzes Aufblinken des Terminals bei Bell
`notifyLongCommand`	true	Benachrichtigung bei Commands > N Sekunden (nur im Hintergrund)
`webhookURL`	—	POST-Request an eigene URL bei Command-Ende

Seite 5: Speicher & Sessions

Project Memory, Session-Persistenz, Backup und Broadcast-Steuerung.

Einstellung	Standard	Beschreibung
`projectMemoryEnabled`	true	Project Memory aktivieren (Kontext pro Verzeichnis)
`projectMemoryRetention`	30 Tage	Aufbewahrung: 7 Tage · 30 Tage · Unbegrenzt
`saveTabsOnQuit`	true	Tabs beim Beenden speichern
`restoreWorkspacesOnLaunch`	true	Workspaces beim Start wiederherstellen

Seite 6: Shell Integration

Optionales Shell-Script das präzises Command-Tracking über OSC 133/7 ermöglicht. Kann ein-/ausgeschaltet werden.

Seite 7: KI-Assistent

Provider-Auswahl (Anthropic/OpenAI), API Keys, Modell-Konfiguration und Kontext-Steuerung.

Einstellung	Standard	Beschreibung
`aiEnabled`	false	KI-Assistent aktivieren (relay ask / relay explain)
`aiProvider`	anthropic	Provider: anthropic · openai
`aiContextLines`	50	Anzahl Shell-History-Zeilen als Kontext (0 = kein Kontext)

Relay-spezifische Variablen

RELAY_PROMPT_STYLE # Aktiver Prompt-Stil
RELAY_AI_PROVIDER # AI-Provider (anthropic/openai)
RELAY_AI_API_KEY # API-Schlüssel
RELAY_AI_MODEL # Modell-ID
RELAY_AI_CONTEXT # Shell-Kontext für AI

Relay Dokumentation

Installation

Direkt-Download

Homebrew

Erste Schritte

Theme wählen

Prompt-Stil einstellen

Workspace einrichten

Tastenkürzel

Theme-System

Drei-Ebenen-Architektur

AppTheme

TerminalTheme

PromptStyle

Glass Themes

Retro Themes

Design-Tokens

Hell/Dunkel-Modus

Farb-Schema

Pane-Layouts

Prompt-Stile

Workspaces

Project Memory

Speicherort

Shell-Integration

Unterstützte Shells

OSC-Sequenzen

Shell-Modi

Relay Prompt

User .zshrc

Per-Pane Shell-Modus

Info-Panel

Project Memory

Recent Commands

Favorites

Working Directories

Offene Ports

VPN-Erkennung

AI Agent

Verwendung

Provider

Slash-Commands

Automatisches Error-Explain

Semantic Colorizer

Command Blocks

Inline Autocomplete

Inline-Bilder

Automatischer Profil-Wechsel

Klickbare Pfade & URLs

Regex-Trigger

Parametrisierte Snippets

Sticky Command Header

Session Blueprints

Pane-Farbmarkierung

CI/CD Pipeline Monitor

Sidebar Cockpit

Inline Workflow

Pipeline Step-Rings

Workspace-Verzeichnis-Inheritance

Code-Editor (v1.2)

Tastenkürzel

Stack Detector (v1.2)

Terminal-Suche

Broadcast-Eingabe

VPN-Erkennung

Unterstützte Provider (14+)

Was angezeigt wird

Wann sichtbar

Polish & Atmosphäre

Einstellungen

Seite 1: Erscheinungsbild

Seite 2: Tastatur

Seite 3: Shell & Umgebung

Seite 4: Benachrichtigungen

Seite 5: Speicher & Sessions

Seite 6: Shell Integration

Seite 7: KI-Assistent

Relay-spezifische Variablen