IRIS — een snel Fig-alternatief voor terminal-autocomplete

Als je Fig hebt gebruikt voor commando-autocomplete in de macOS-console, herinner je je waarschijnlijk het slechte nieuws van najaar 2024. Het project werd stopgezet en het werk werd ondergebracht bij Amazon Q Developer met verplichte cloud-inlog en een zware interface.

IntelliSense-achtige autocomplete in de terminal is echt handig. Je went snel aan het gemak: begin met typen van een utilitynaam en er verschijnt een menu met argumenten, Git-branches of flags.

De auteur van het IRIS-project besloot dit concept helemaal opnieuw op te bouwen. In plaats van Electron en server-afhankelijkheden creëerde hij een enkele Go-binary die popups met suggesties rechtstreeks in de TTY weergeeft.

Waarom TTY Alles Verandert

Grafische overlays zoals Fig zijn sterk gekoppeld aan specifieke besturingssystemen en grafische terminals. Probeer Fig's overlay door te sturen naar een SSH-sessie op een externe Linux-server of draai het in een kale virtuele console — niets werkt.

IRIS neemt een andere aanpak. Het injecteert rechtstreeks in de terminaluitvoer (TTY), waardoor het native werkt in diverse omgevingen:

• Lokale terminals op macOS en Linux
• Externe sessies via SSH
• Sessies binnen tmux
• Linux virtuele consoles zonder grafische shell

Het instellen van de omgeving op een server is zo simpel als het kopiëren van één bestand. Geen plugin-managers voor Zsh of Fish nodig, geen zoeken naar thema's, geen gigabytes aan afhankelijkheden.

Wat Er Binnen Zit en Hoe Het Werkt

IRIS indexeert je aliassen en commando-geschiedenis. Wanneer je begint met typen, haalt het tool de meest relevante suggesties op uit je geschiedenis of commando-specificaties.

Twee visuele stijlen zijn beschikbaar: Modern en Klassiek. De Moderne stijl ziet er zachter uit en gebruikt Nerd Fonts-pictogrammen, terwijl de Klassieke stijl eenvoudiger is en meer lijkt op traditionele TUI-interfaces.

Een bijzondere functie is de ondersteuning voor neurale netwerken. Als je contextbewuste suggesties wilt, kun je een AI-provider inschakelen in de configuratie. Standaard ondersteunt het:

1. Groq (werkt via cloud API, een gratis sleutel volstaat)
2. Ollama (voor wie lokale modellen draait zoals qwen2.5-coder)

Input debounce wordt geregeld via de debounce_ms parameter. Als je gewend bent aan snel typen, zal de AI je niet overspoelen met verzoeken bij elke toetsaanslag.

Het configuratiebestand gebruikt eenvoudige TOML-structuren en bevindt zich op ~/.config/iris/config.toml. Wijzigingen worden direct toegepast, dus er is geen noodzaak om de shell opnieuw te starten.

[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

Valkuilen en Installatietips

Er zijn meerdere manieren om het tool te installeren. AUR heeft het iris-autocomplete pakket, Homebrew heeft de versenilvis/iris/iris formula. Nix Flakes-gebruikers kunnen ook voorgebouwde pakketten vinden, plus reguliere Debian .deb en .rpm pakketten in de GitHub-releases.

Voor het starten, schakel je bestaande autocomplete-plugins uit. Tools zoals zsh-autosuggestions of atuin onderscheppen toetsencombinaties en zullen het scherm volladen met dubbele tekst.

Windows wordt nog niet ondersteund. Ontwikkelaars op dit besturingssysteem moeten het tool draaien binnen WSL.

Menunavigatie gebruikt vertrouwde sneltoetsen:

• Shift + Tab — menu verbergen of tonen
• Tab — het geselecteerde commando invoegen
• Стрелка вправо — ghost-tekstsuggestie accepteren
• Ctrl + R — modus omschakelen (geschiedenis of specs)

In debug-modus logt iris -d alles wat je typt in de console. Houd hier rekening mee bij het indienen van bugrapporten om te voorkomen dat je per ongeluk wachtwoorden of privésleutels lekt.

Is Het de Moeite Waard om Te Proberen

Als je Fig mist of het beu bent om dezelfde autocomplete-plugins op een dozijn servers te configureren, lijkt IRIS een verstandig alternatief. Het vereist geen registratie, is lichtgewicht en start snel op.

Het project is open source onder de 0BSD-licentie, wat betekent dat de code volledig vrij is voor elk gebruik.