Repolode
Enviar
Realiserad

Realiserad/fish-ai

Plugin para Fish que usa LLMs para transformar comentários em comandos, explicar comandos, corrigir erros de digitação e autocompletar a linha de comando.

Ver no GitHub
Estrelas
567
Forks
51
Issues abertas
1
Último commit
ontem

O que é?

fish-ai é um plugin para o Fish que conecta a linha de comando a um modelo de linguagem. Você digita um comentário, como a descrição de uma tarefa, e pressiona um atalho para obter um comando de shell; ou digita um comando e recebe um comentário explicando o que ele faz. Isso ajuda a usar ferramentas com muitas opções, como git, kubectl e curl.

O plugin também pode sugerir uma correção quando um comando falha e oferece autocomplete para comandos ou comentários. Os resultados aparecem em um fuzzy finder fzf integrado, onde você pode refinar as sugestões com instruções adicionais. Tudo é acionado por atalhos de teclado configuráveis, e a instalação é feita com o fisher.

O backend do modelo é definido em um arquivo de configuração INI. Há suporte a provedores como Anthropic, OpenAI, Google, AWS Bedrock, Groq, Cohere e OpenRouter, além de qualquer servidor compatível com OpenAI hospedado por você, como o Ollama. O plugin envia ao modelo o nome do sistema operacional, o buffer de comandos e o contexto relacionado, e oculta alguns valores confidenciais, como chaves de API passadas como argumentos.

Recursos principais

  • 01Transforma comentários em comandos de shell e explica comandos existentes em comentários.
  • 02Sugere correções para comandos que falharam.
  • 03Autocompleta comandos com um seletor baseado em fzf, que pode ser refinado com instruções.
  • 04Funciona com vários provedores, incluindo servidores compatíveis com OpenAI hospedados por você.
  • 05Os atalhos de teclado são configuráveis e não é necessário usar o mouse.
  • 06Oferece suporte a um idioma de explicação configurável e a cabeçalhos HTTP personalizados.

Casos de uso

  • Consultar opções de git, kubectl ou curl sem sair do terminal.
  • Criar um pipeline de shell pontual a partir de uma descrição em linguagem natural.
  • Investigar um erro de digitação ou comando com falha e obter uma versão corrigida.
  • Executar um modelo hospedado por você para manter o contexto dos comandos na sua máquina.

Início rápido

  1. 1

    Instale o git e o uv, ou uma versão compatível do Python com pip e venv

  2. 2

    Instale o plugin com o fisher

    fisher install realiserad/fish-ai
  3. 3

    Crie o arquivo de configuração ~/.config/fish-ai.ini com o provedor de modelos de linguagem escolhido

Antes de usar

  • É necessária uma chave de API de um provedor de modelos hospedados ou um modelo auto-hospedado.
  • A linha de comando, o nome do sistema operacional e a saída de comandos relacionados ou o conteúdo de arquivos são enviados ao modelo de linguagem.

Em coleções

Rode LLMs localmenteFerramentas de CLI e terminal

Tópicos

#fish#shell#llm#command-line#autocomplete#terminal#ollama#fish-plugin#fisher

Perguntas frequentes

O que é fish-ai?
Plugin para Fish que usa LLMs para transformar comentários em comandos, explicar comandos, corrigir erros de digitação e autocompletar a linha de comando. fish-ai é um plugin para o Fish que conecta a linha de comando a um modelo de linguagem. Você digita um comentário, como a descrição de uma tarefa, e pressiona um atalho para obter um comando de shell; ou digita um comando e recebe um comentário explicando o que ele faz. Isso ajuda a usar ferramentas com muitas opções, como git, kubectl e curl.
fish-ai é gratuito? Qual é a licença?
fish-ai é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
fish-ai ainda é mantido?
Manutenção ativa. O último commit de fish-ai foi em 5 de nov. de 2026.
Para que posso usar fish-ai?
Consultar opções de git, kubectl ou curl sem sair do terminal. Criar um pipeline de shell pontual a partir de uma descrição em linguagem natural. Investigar um erro de digitação ou comando com falha e obter uma versão corrigida. Executar um modelo hospedado por você para manter o contexto dos comandos na sua máquina.
Como instalar fish-ai?
Instale o git e o uv, ou uma versão compatível do Python com pip e venv Instale o plugin com o fisher: fisher install realiserad/fish-ai Crie o arquivo de configuração ~/.config/fish-ai.ini com o provedor de modelos de linguagem escolhido
Onde consigo fish-ai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Realiserad/fish-ai

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados