Cowsay API: como usar a vaca falante no terminal

O Cowsay é uma ferramenta de linha de comando que exibe mensagens de texto no balão de fala de uma vaca desenhada em ASCII (American Standard Code for Information Interchange). Criado em Perl por Tony Monroe em 1999, ele dá personalidade a scripts e avisos no terminal do Linux, do macOS e do Node.js.

• O que é o Cowsay?
• Como instalar e usar o Cowsay no terminal?
• Personalizando o Cowsay: flags, cowfiles e cowthink
• Quando usar o Cowsay em projetos reais?
• Cowsay, Fortune ou Figlet: qual escolher?

O que é o Cowsay?

O Cowsay é um programa de CLI (interface de linha de comando) escrito em Perl que imprime no terminal uma vaca em arte ASCII "falando" a mensagem que o usuário fornecer. O manual oficial o define, com humor, como "configurable speaking/thinking cow (and a bit more)" — uma vaca falante (ou pensante) configurável, e um pouco mais, segundo o man page do cowsay.

Tony Monroe lançou o Cowsay em 1999, inspirado na cultura de vacas ASCII da comunidade de ciência da computação da Universidade da Califórnia em Berkeley, conforme relata o site oficial do projeto. Em 2016, Monroe publicou a versão final 3.04 do código original e a comunidade assumiu a manutenção por meio do fork cowsay-org/cowsay, mantido por Andrew Janke.

A brincadeira continua viva no ecossistema JavaScript: o pacote npm cowsay, mantido por Fabio Crisci sob licença MIT e na versão 1.6.0, registrou 88.679 downloads na semana de 2 a 8 de julho de 2026, segundo a API pública de downloads do npm. Embora seja popularmente buscado como "Cowsay API", ele funciona tanto como comando de terminal quanto como API JavaScript importável em aplicações Node.js.

Além da diversão, o Cowsay tem utilidade prática: destacar visualmente mensagens importantes em scripts, builds e sessões de terminal compartilhadas.

Como instalar e usar o Cowsay no terminal?

Para instalar o Cowsay, use o gerenciador de pacotes do seu sistema operacional ou o npm do Node.js. O processo completo leva menos de um minuto:

1. Instale pelo gerenciador do sistema: no Ubuntu e em derivados do Debian, execute sudo apt-get install cowsay; em outras distribuições Linux, use o equivalente (yum, dnf, pacman).
2. Ou instale pelo npm: com o Node.js configurado, execute npm install -g cowsay. Se tiver dúvidas sobre npm e yarn, veja nosso guia de gerenciadores de pacotes.
3. Execute o comando com a sua mensagem: digite cowsay "Olá Mundo!" e a vaca aparece no terminal com o texto no balão de fala.
4. Teste sem instalar nada: rode npx cowsay "Olá Mundo!" — o npx, executor de pacotes do npm, baixa e executa o pacote na hora.

No terminal, o resultado fica assim:

cowsay "Olá Mundo!"

Ou, usando o npx:

npx cowsay "Olá Mundo!"

O pacote npm também funciona como módulo dentro do código. Basta importar e chamar a função say:

const cowsay = require('cowsay')

console.log(cowsay.say({ text: 'Olá, CodeCrush!' }))

Esse uso programático é útil para gerar mensagens em ferramentas de linha de comando próprias, sem depender do binário instalado no sistema.

Personalizando o Cowsay: flags, cowfiles e cowthink

O Cowsay aceita flags que mudam o personagem, os olhos e até o formato do balão. As principais opções documentadas no manual são:

• -f <cowfile>: troca a vaca por outro personagem (um "cowfile"). Exemplo: cowsay -f tux "Olá Tux!" exibe o pinguim do Linux.
• -l: lista todos os cowfiles disponíveis no sistema.
• -e <olhos>: personaliza os olhos do personagem com dois caracteres, como -e "^^".
• -T <língua>: define a língua do personagem, como -T " U".
• cowthink: invocado no lugar de cowsay, faz a vaca "pensar" a mensagem em um balão de nuvem.

Veja o exemplo com o Tux:

npx cowsay -f tux "Olá Tux!"

Quem quiser ir além pode criar cowfiles próprios: são arquivos de texto simples que definem o desenho em ASCII, e o formato está documentado no repositório oficial do cowsay.

Quando usar o Cowsay em projetos reais?

O Cowsay é ideal sempre que você quiser destacar uma mensagem no terminal de forma impossível de ignorar — e arrancar um sorriso no processo. Os usos mais comuns entre desenvolvedores são:

1. Sinalize o status de scripts: exiba sucesso ou falha de um build ou deploy com um personagem diferente para cada resultado.
2. Crie mensagens de boas-vindas: adicione o Cowsay ao arquivo de inicialização do shell para receber a equipe com uma frase do dia.
3. Deixe avisos visíveis em servidores compartilhados: uma vaca ASCII chama mais atenção do que uma linha de log comum.
4. Ensine conceitos de terminal: o Cowsay é um primeiro comando divertido para quem está aprendendo os comandos fundamentais do terminal.

Em pipelines sérios de produção, use com moderação: a graça está no contraste, não na repetição.

Cowsay, Fortune ou Figlet: qual escolher?

A escolha depende do efeito desejado: o Cowsay dá voz a um personagem, o Fortune sorteia frases e o Figlet transforma texto em banner. A tabela resume as opções clássicas de diversão no terminal:

As ferramentas se combinam bem entre si: o encadeamento fortune | cowsay é um clássico dos terminais Unix, fazendo a vaca "falar" uma citação aleatória a cada execução.

Conclusão

O Cowsay prova que nem toda ferramenta precisa resolver um problema grave para merecer lugar no seu terminal: às vezes, o valor está em humanizar o dia a dia de quem programa. Instale com um comando, personalize com -f e use a versão npm quando quiser a vaca dentro do seu próprio código JavaScript. Aqui no CodeCrush, a recomendação é prática: adote o Cowsay nos pontos do fluxo em que uma mensagem precisa ser vista — e deixe a vaca trabalhar pelo seu deploy.