IRIS — un'alternativa veloce a Fig per l'autocomplete nel terminale

Se hai usato Fig per l'autocomplete dei comandi nella console macOS, probabilmente ricorderai le brutte notizie dell'autunno 2024. Il progetto è stato chiuso e il lavoro è confluito in Amazon Q Developer con login cloud obbligatorio e un'interfaccia pesante.

L'autocomplete di tipo IntelliSense nel terminale è davvero utile. Ti abitui rapidamente alla praticità: inizi a digitare il nome di un'utilità e appare un menu con argomenti, branch Git o flag.

L'autore del progetto IRIS ha deciso di ricostruire questo concetto da zero. Invece di Electron e dipendenze server, ha creato un singolo binario Go che mostra i suggerimenti popup direttamente nel TTY.

Perché TTY cambia tutto

Gli overlay grafici tradizionali come Fig sono strettamente legati a sistemi operativi specifici e terminali grafici. Prova a inoltrare l'overlay di Fig in una sessione SSH su un server Linux remoto o a eseguirlo in una semplice console virtuale—non funziona nulla.

IRIS adotta un approccio diverso. Si inietta direttamente nell'output del terminale (TTY), permettendogli di funzionare nativamente in ambienti diversi:

• Terminali locali su macOS e Linux
• Sessioni remote tramite SSH
• Sessioni all'interno di tmux
• Console virtuali Linux senza shell grafica

Configurare l'ambiente su un server è semplice come copiare un singolo file. Non c'è bisogno di installare gestori di plugin per Zsh o Fish, cercare temi o scaricare gigabyte di dipendenze.

Cosa c'è dentro e come funziona

IRIS indicizza i tuoi alias e la cronologia dei comandi. Quando inizi a digitare, lo strumento mostra i suggerimenti più pertinenti dalla tua cronologia o dalle specifiche dei comandi.

Sono disponibili due stili visivi: Modern e Classic. Lo stile Modern appare più morbido e utilizza le icone di Nerd Fonts, mentre Classic è più semplice e più vicino alle interfacce TUI tradizionali.

Una funzionalità distintiva è il supporto per le reti neurali. Se vuoi suggerimenti contestuali, puoi abilitare un provider AI nella configurazione. Funziona immediatamente con:

1. Groq (funziona tramite API cloud, basta una chiave gratuita)
2. Ollama (per chi esegue modelli locali come qwen2.5-coder)

Il debounce dell'input è controllato dal parametro debounce_ms. Se sei abituato a digitare velocemente, l'AI non ti sommergerà di richieste a ogni tasto premuto.

Il file di configurazione utilizza strutture TOML semplici e si trova in ~/.config/iris/config.toml. Le modifiche vengono rilevate immediatamente, quindi non c'è bisogno di riavviare la shell.

[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

Dettagli importanti e suggerimenti per l'installazione

Ci sono diversi modi per installare lo strumento. AUR ha il pacchetto iris-autocomplete, Homebrew ha la formula versenilvis/iris/iris. Gli utenti di Nix Flakes possono anche trovare pacchetti precompilati, oltre ai normali pacchetti Debian .deb e .rpm nelle release di GitHub.

Prima di avviare, disabilita eventuali plugin di autocomplete esistenti che stai utilizzando. Strumenti come zsh-autosuggestions o atuin intercetteranno le combinazioni di tasti e ingomberanno lo schermo con testo duplicato.

Windows non è ancora supportato. Gli sviluppatori su questo sistema operativo dovranno eseguire lo strumento all'interno di WSL.

La navigazione del menu utilizza scorciatoie familiari:

• Shift + Tab — nascondere o mostrare il menu
• Tab — inserire il comando selezionato
• Стрелка вправо — accettare il suggerimento ghost text
• Ctrl + R — cambiare modalità (cronologia o specifiche)

In modalità debug, iris -d registra tutto ciò che digiti nella console. Tienilo a mente quando invii segnalazioni di bug per evitare di trapelare accidentalmente password o chiavi private.

Vale la pena provarlo

Se ti manca Fig o sei stanco di configurare gli stessi plugin di autocomplete su una dozzina di server, IRIS sembra un'alternativa sensata. Non richiede registrazione, è leggero e si avvia rapidamente.

Il progetto è open source con licenza 0BSD, il che significa che il codice è completamente libero per qualsiasi uso.