IRIS — Uma Alternativa Rápida ao Fig para Autocompletar no Terminal

Se você já usou o Fig para autocompletar comandos no terminal do macOS, provavelmente se lembra das más notícias do outono de 2024. O projeto foi descontinuado e o trabalho foi integrado ao Amazon Q Developer com login obrigatório na nuvem e uma interface pesada.

O autocompletar estilo IntelliSense no terminal é genuinamente útil. Você rapidamente se acostuma com a conveniência: começa a digitar o nome de um utilitário e um menu aparece com argumentos, branches do Git ou flags.

O autor do projeto IRIS decidiu reconstruir esse conceito do zero. Em vez de Electron e dependências de servidor, criou um único binário em Go que renderiza sugestões em popup diretamente no TTY.

Por Que o TTY Muda Tudo

As sobreposições gráficas tradicionais como o Fig são fortemente acopladas a sistemas operacionais e terminais gráficos específicos. Tentar encaminhar a sobreposição do Fig para uma sessão SSH em um servidor Linux remoto ou executá-la em um console virtual simples — nada funciona.

O IRIS adota uma abordagem diferente. Ele injeta diretamente na saída do terminal (TTY), tornando-o nativo em ambientes diversos:

• Terminais locais em macOS e Linux
• Sessões remotas via SSH
• Sessões dentro do tmux
• Consoles virtuais Linux sem shell gráfico

Configurar o ambiente em um servidor é tão simples quanto copiar um único arquivo. Não há necessidade de instalar gerenciadores de plugins para Zsh ou Fish, caçar temas ou baixar gigabytes de dependências.

O Que Tem Dentro e Como Funciona

O IRIS indexa seus aliases e histórico de comandos. Quando você começa a digitar, a ferramenta exibe as sugestões mais relevantes do seu histórico ou especificações de comandos.

Dois estilos visuais estão disponíveis: Moderno e Clássico. O estilo Moderno parece mais suave e usa ícones Nerd Fonts, enquanto o Clássico é mais simples e se aproxima das interfaces TUI tradicionais.

Um recurso que se destaca é o suporte a redes neurais. Se você deseja sugestões contextuais, pode ativar um provedor de IA na configuração. Nativamente, suporta:

1. Groq (funciona via API na nuvem, uma chave gratuita é suficiente)
2. Ollama (para quem executa modelos locais como qwen2.5-coder)

O debounce de entrada é controlado pelo parâmetro debounce_ms. Se você está acostumado a digitar rápido, a IA não vai te inundar com solicitações a cada tecla pressionada.

O arquivo de configuração usa estruturas TOML simples e fica em ~/.config/iris/config.toml. As alterações são capturadas em tempo real, então não há necessidade de reiniciar o 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

Pecadilhos e Dicas de Instalação

Existem várias formas de instalar a ferramenta. O AUR tem o pacote iris-autocomplete, o Homebrew tem a fórmula versenilvis/iris/iris. Usuários de Nix Flakes também podem encontrar pacotes pré-construídos, além de pacotes .deb .deb e .rpm .rpm regulares nos lançamentos do GitHub.

Antes de iniciar, desative quaisquer plugins de autocompletar existentes que você esteja usando. Ferramentas como zsh-autosuggestions ou atuin vão interceptar combinações de teclas e desorganizar a tela com texto duplicado.

Windows ainda não é suportado. Desenvolvedores nesse sistema operacional precisarão executar a ferramenta dentro do WSL.

A navegação no menu usa atalhos familiares:

• Shift + Tab — mostrar ou ocultar o menu
• Tab — inserir o comando selecionado
• Стрелка вправо — aceitar a sugestão de texto fantasma
• Ctrl + R — alternar modo (histórico ou especificações)

No modo debug, iris -d registra tudo o que você digita no console. Leve isso em conta ao enviar relatórios de bugs para evitar vazar senhas ou chaves privadas acidentalmente.

Vale a Pena Experimentar

Se você sente falta do Fig ou está cansado de configurar os mesmos plugins de autocompletar em uma dúzia de servidores, o IRIS parece uma alternativa sensata. Não requer registro, é leve e inicia rapidamente.

O projeto é open source sob a licença 0BSD, o que significa que o código é completamente livre para qualquer uso.