nlsh
Junaid Mahmood · Programação · Outros
O nlsh é uma ferramenta de linha de comando de código aberto que traduz inglês simples em comandos de shell que funcionam. Em vez de decorar flags e sintaxe, você descreve a tarefa e o nlsh descobre o comando certo para o seu terminal. Roda no macOS e no Linux, precisa do Python 3.8 ou mais recente e se conecta ao provedor de IA que você escolher, então você mantém o controle da sua própria chave de API e do seu histórico.
Sobre nlsh
O que é o nlsh
O nlsh é um shell de linguagem natural. Você digita algo como "lista todos os arquivos python" e ele devolve find . -name "*.py", pronto para rodar. O projeto existe porque a maioria das pessoas esquece a sintaxe do shell justo quando precisa dela, e garimpar resultados de busca pela flag certa gasta um tempo que você poderia usar no problema real. O nlsh fica entre você e o bash, convertendo intenção em comando.
Foi feito para quem vive no terminal mas não quer um diploma de ciência da computação para usá-lo. Iniciantes ganham uma entrada suave; desenvolvedores experientes ganham um caminho mais rápido para comandos que lembram pela metade. A ferramenta é de código aberto e roda localmente, então nada sai da sua máquina além do prompt que você envia ao provedor de IA. Esse último ponto importa se você mexe com arquivos sensíveis.
Os maiores limites são o sistema e os provedores. O Windows não tem suporte, e a configuração de API embutida funciona hoje com o Gemini. Você também precisa da sua própria chave de API, porque o nlsh não inclui conta nem backend hospedado. Ainda assim, para uma ferramenta gratuita que faz bem um único trabalho, é uma lista curta de ressalvas.
Como começar
- Confirme que você está no macOS ou no Linux com o Python 3.8 ou mais recente instalado.
- Instale com o script de uma linha:
curl -fsSL https://raw.githubusercontent.com/junaid-mahmood/nlsh/main/install.sh | bash. - Inicie a sessão digitando
nlshno seu terminal. - Configure a chave de API do seu provedor de LLM com o comando
!api. - Descreva o que você quer em inglês simples e revise o comando sugerido antes de rodar.
Digite !help para ver a lista completa de comandos, !cmd para rodar um comando de shell direto ou Ctrl+D para sair.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de nlsh.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Iniciantes no terminal que travam diante de um prompt vazio e precisam que o inglês simples vire comandos de verdade.
- Desenvolvedores experientes que sabem que um comando existe mas não lembram as flags exatas e querem um atalho rápido.
Tarefas
- Transformar uma tarefa como "mata o processo na porta 3000" em `lsof -t -i
- Escrever commits do git, contar linhas ou achar arquivos descrevendo o objetivo em vez da sintaxe.
Cenários
- Trabalhar num servidor Linux remoto por SSH, onde você não pode contar com uma interface gráfica e cada consulta custa o seu ritmo.
- Aprender bash num Mac pessoal, onde um palpite errado sai barato porque você revisa o comando antes de rodar.
Principais recursos
De inglês simples a comandos de shell
O núcleo do nlsh é a tradução. Você descreve um trabalho com palavras do dia a dia e ele devolve o comando bash que faz aquilo, mais uma explicação curta do que cada parte significa. Cobre tarefas comuns como listar arquivos, preparar mudanças do git e checar o uso do disco. Chega de trocar de aba para um buscador no meio da tarefa.
Entende a intenção, não só palavras-chave
Peça "commit com mensagem fixed bug" e ele mapeia o seu texto para git commit -m "fixed bug". A intenção importa mais do que a frase exata, então você não precisa aprender uma linguagem de consulta só para falar com o seu próprio computador.
Roda localmente com a sua própria chave
O nlsh roda na sua máquina e só envia os seus prompts ao provedor de IA que você configurar. Não há conta para criar nem servidor coletando o seu histórico de comandos. O comando !api deixa você trocar a chave de API com segurança. Quer saber onde os seus dados vão parar? Vão para o seu provedor, e para nenhum outro lugar.
Saída de emergência para o comando direto
O comando !cmd roda um comando de shell direto, pulando a etapa de linguagem natural. Ele existe para quando você já sabe exatamente o que quer e não precisa de ajuda, deixando você misturar o trabalho normal no terminal com o assistente na mesma sessão. Às vezes você só quer digitar você mesmo.
Código aberto e gratuito
O projeto inteiro é de código aberto no GitHub, no repositório junaid-mahmood/nlsh. Não há plano pago, nem limite de uso, nem upsell. Você paga só pelo provedor de IA que conectar, e só pelas requisições que enviar de fato, o que mantém o custo previsível se você usar pouco. Faça um fork, inspecione ou mude o código se os padrões não combinam com o seu jeito de trabalhar.
Prós e contras
Prós
- Transforma intenção vaga em comandos de shell precisos, o que reduz o tempo que você gasta procurando a sintaxe certa.
- Gratuito e de código aberto, sem conta, sem assinatura e sem recursos bloqueados.
- Roda localmente e mantém o seu histórico fora de qualquer servidor de terceiros.
- Amigável para iniciantes, porque explica o comando gerado em vez de só entregar uma string críptica.
Contras
- O Windows não tem suporte, então não serve se for a sua única máquina.
- A configuração de API embutida só aceita o Gemini por enquanto, o que limita a escolha de provedor.
- Precisa da própria chave de API, então há um passo de configuração e um pequeno custo por requisição antes de funcionar.
- Você ainda precisa revisar e rodar cada comando por conta própria, então não substitui de todo o conhecimento de shell.
Perguntas frequentes
Sim. O nlsh é gratuito e de código aberto, sem planos pagos. Você só paga ao seu provedor de IA pelas chamadas de API que faz, e muitos provedores oferecem um nível gratuito que cobre o uso leve.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a nlsh.
Alternativas a nlsh
Base Code
Base44 (Wix) · Programação · ProdutividadeO Base Code é um ambiente de desenvolvimento em nuvem compartilhado da Base44. O time descreve mudanças em um repositório do GitHub pelo chat, confere tudo na prévia e envia o resultado como pull request.
Google EmbeddingGemma 2
Google DeepMind · Escrita · Imagem · ProgramaçãoGoogle EmbeddingGemma 2 é um modelo aberto de 740 milhões de parâmetros que transforma texto, código, imagens, áudio e quadros de vídeo em vetores de um único espaço de 768 dimensões, rodando em celulares e notebooks.
GitGlow
GitGlow · Programação · ProdutividadeO GitGlow é um cliente Git de desktop que coloca seu código e as mudanças dos seus agentes de IA na mesma revisão, para você saber o que vai sair da máquina antes de publicar.