Cowsay API: how to use the talking cow in the terminal

Cowsay is a command-line tool that displays text messages in the speech bubble of a cow drawn in ASCII (American Standard Code for Information Interchange). Created in Perl by Tony Monroe in 1999, it gives personality to scripts and warnings in the Linux, macOS and Node.js terminal.

• What is Cowsay?
• How to install and use Cowsay in the terminal?
• Customizing Cowsay: flags, cowfiles and cowthink
• When to use Cowsay in real projects?
• Cowsay, Fortune or Figlet: which to choose?

What is Cowsay?

Cowsay is a CLI (command-line interface) program written in Perl that prints to the terminal a cow in ASCII art "speaking" the message the user provides. The official manual defines it, with humor, as "configurable speaking/thinking cow (and a bit more)" — a configurable speaking (or thinking) cow, and a bit more, according to the cowsay man page.

Tony Monroe released Cowsay in 1999, inspired by the ASCII cow culture of the University of California Berkeley computer science community, as reported on the official project site. In 2016, Monroe published the final version 3.04 of the original code and the community took over maintenance through the fork cowsay-org/cowsay, maintained by Andrew Janke.

The fun continues alive in the JavaScript ecosystem: the npm cowsay package, maintained by Fabio Crisci under the MIT license and at version 1.6.0, recorded 88,679 downloads in the week of July 2-8, 2026, according to the public npm downloads API. Although popularly searched as "Cowsay API", it works both as a terminal command and as a JavaScript API importable in Node.js applications.

Beyond the fun, Cowsay has practical utility: visually highlighting important messages in scripts, builds and shared terminal sessions.

How to install and use Cowsay in the terminal?

To install Cowsay, use your operating system package manager or the npm from Node.js. The full process takes less than a minute:

1. Install via the system package manager: on Ubuntu and Debian derivatives, run sudo apt-get install cowsay; on other Linux distributions, use the equivalent (yum, dnf, pacman).
2. Or install via npm: with Node.js configured, run npm install -g cowsay. If you have doubts about npm and yarn, see our package managers guide.
3. Run the command with your message: type cowsay "Hello World!" and the cow appears in the terminal with the text in the speech bubble.
4. Test without installing anything: run npx cowsay "Hello World!" — npx, the npm package runner, downloads and runs the package on the spot.

In the terminal, the result looks like this:

cowsay "Hello World!"

Or, using npx:

npx cowsay "Hello World!"

The npm package also works as a module inside code. Just import and call the say function:

const cowsay = require('cowsay')

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

This programmatic usage is useful for generating messages in your own command-line tools, without depending on the system-installed binary.

Customizing Cowsay: flags, cowfiles and cowthink

Cowsay accepts flags that change the character, the eyes and even the bubble shape. The main options documented in the manual are:

• -f <cowfile>: switches the cow to another character (a "cowfile"). Example: cowsay -f tux "Hello Tux!" displays the Linux penguin.
• -l: lists all available cowfiles on the system.
• -e <eyes>: customizes the character eyes with two characters, like -e "^^".
• -T <tongue>: sets the character tongue, like -T " U".
• cowthink: invoked instead of cowsay, makes the cow "think" the message in a cloud bubble.

See the example with Tux:

npx cowsay -f tux "Hello Tux!"

Those who want to go further can create custom cowfiles: they are simple text files that define the ASCII drawing, and the format is documented in the official cowsay repository.

When to use Cowsay in real projects?

Cowsay is ideal whenever you want to highlight a message in the terminal in a way that is impossible to ignore — and draw a smile in the process. The most common uses among developers are:

1. Signal script status: display success or failure of a build or deploy with a different character for each result.
2. Create welcome messages: add Cowsay to the shell startup file to greet the team with a quote of the day.
3. Make warnings visible on shared servers: an ASCII cow draws more attention than a common log line.
4. Teach terminal concepts: Cowsay is a fun first command for those learning the fundamental terminal commands.

In serious production pipelines, use in moderation: the fun is in the contrast, not in repetition.

Cowsay, Fortune or Figlet: which to choose?

The choice depends on the desired effect: Cowsay gives voice to a character, Fortune draws quotes and Figlet turns text into a banner. The table summarizes the classic options for terminal fun:

The tools combine well with each other: the pipeline fortune | cowsay is a classic of Unix terminals, making the cow "speak" a random quote on each run.

Conclusion

Cowsay proves that not every tool needs to solve a serious problem to deserve a place in your terminal: sometimes the value is in humanizing the daily life of those who program. Install with one command, customize with -f and use the npm version when you want the cow inside your own JavaScript code. Here at CodeCrush, the recommendation is practical: adopt Cowsay at the points in the flow where a message needs to be seen — and let the cow work for your deploy.