IRIS — Eine schnelle Fig-Alternative für Terminal-Autovervollständigung

Wenn du Fig für die Befehlsautovervollständigung in der macOS-Konsole verwendet hast, erinnerst du dich wahrscheinlich an die schlechten Nachrichten vom Herbst 2024. Das Projekt wurde eingestellt, und die Arbeit wurde in Amazon Q Developer überführt – mit obligatorischer Cloud-Anmeldung und einer schwergewichtigen Oberfläche.

IntelliSense-artige Autovervollständigung im Terminal ist wirklich nützlich. Man gewöhnt sich schnell an den Komfort: Du beginnst, einen Utility-Namen einzutippen, und ein Menü erscheint mit Argumenten, Git-Branches oder Flags.

Der IRIS-Projektautor beschloss, dieses Konzept von Grund auf neu aufzubauen. Anstatt Electron und Server-Abhängigkeiten nutzt er eine einzelne Go-Binary, die Popup-Vorschläge direkt im TTY rendert.

Warum TTY alles verändert

Grafische Overlays wie Fig sind traditionell eng an bestimmte Betriebssysteme und grafische Terminals gekoppelt. Versuche Fig's Overlay in eine SSH-Sitzung auf einem entfernten Linux-Server weiterzuleiten oder es in einer nackten virtuellen Konsole auszuführen – nichts funktioniert.

IRIS geht einen anderen Weg. Es injiziert direkt in die Terminal-Ausgabe (TTY) und macht es dadurch nativ in verschiedenen Umgebungen einsetzbar:

• Lokale Terminals auf macOS und Linux
• Entfernte Sitzungen über SSH
• Sitzungen innerhalb von tmux
• Linux virtuelle Konsolen ohne grafische Shell

Die Einrichtung der Umgebung auf einem Server ist so einfach wie das Kopieren einer einzelnen Datei. Es ist nicht nötig, Plugin-Manager für Zsh oder Fish zu installieren, nach Themes zu suchen oder Gigabytes an Abhängigkeiten herunterzuladen.

Was steckt drin und wie es funktioniert

IRIS indiziert deine Aliase und Befehlshistorie. Wenn du mit der Eingabe beginnst, zeigt das Tool die relevantesten Vorschläge aus deiner Historie oder Befehlsspezifikationen an.

Zwei visuelle Stile sind verfügbar: Modern und Classic. Der moderne Stil sieht weicher aus und verwendet Nerd-Fonts-Icons, während Classic einfacher ist und näher an traditionellen TUI-Oberflächen liegt.

Ein herausragendes Feature ist die Unterstützung neuronaler Netze. Wenn du kontextbezogene Vorschläge möchtest, kannst du einen AI-Provider in der Konfiguration aktivieren. Out of the box werden unterstützt:

1. Groq (funktioniert über Cloud-API, ein kostenloser Key genügt)
2. Ollama (für diejenigen, die lokale Modelle wie qwen2.5-coder ausführen)

Das Input-Debouncing wird über den Parameter debounce_ms gesteuert. Wenn du an schnelles Tippen gewöhnt bist, wird die AI dich nicht mit Anfragen bei jeder Tastatureingabe überfluten.

Die Konfigurationsdatei verwendet einfache TOML-Strukturen und befindet sich unter ~/.config/iris/config.toml. Änderungen werden im laufenden Betrieb übernommen, ein Neustart der Shell ist nicht erforderlich.

[core]
mode = "last"
expand-alias = true

[ui]
style = "modern"
ghost-text = true
nerd-fonts = true

[ai]
enabled = false
provider = "ollama"

[ai.providers.ollama]
endpoint = "http://localhost:11434/v1/chat/completions"
model = "qwen2.5-coder"
timeout_ms = 5000

Fallstricke und Installationstipps

Es gibt mehrere Möglichkeiten, das Tool zu installieren. AUR hat das Paket iris-autocomplete, Homebrew hat die Formel versenilvis/iris/iris. Nix-Flakes-Nutzer finden ebenfalls vorgefertigte Pakete, plus reguläre Debian-.deb- und .rpm-Pakete in den GitHub-Releases.

Bevor du startest, deaktiviere alle vorhandenen Autovervollständigungs-Plugins, die du verwendest. Tools wie zsh-autosuggestions oder atuin fangen Tastenkombinationen ab und überladen den Bildschirm mit dupliziertem Text.

Windows wird noch nicht unterstützt. Entwickler auf diesem Betriebssystem müssen das Tool innerhalb von WSL ausführen.

Die Menünavigation verwendet vertraute Tastenkürzel:

• Shift + Tab — Menü aus- oder einblenden
• Tab — den ausgewählten Befehl einfügen
• Стрелка вправо — den Ghost-Text-Vorschlag akzeptieren
• Ctrl + R — Modus umschalten (Historie oder Specs)

Im Debug-Modus protokolliert iris -d alles, was du in der Konsole tippst. Beachte dies, wenn du Fehlerberichte einreichst, um nicht versehentlich Passwörter oder private Schlüssel zu leaken.

Lohnt es sich, es auszuprobieren

Wenn du Fig vermisst oder es leid bist, dieselben Autovervollständigungs-Plugins auf einem Dutzend Servern zu konfigurieren, sieht IRIS nach einer vernünftigen Alternative aus. Es erfordert keine Registrierung, ist leichtgewichtig und startet schnell.

Das Projekt ist Open Source unter der 0BSD-Lizenz, was bedeutet, dass der Code völlig frei für jede Verwendung ist.