A CLI to fetch and compare the 2019 coronavirus pandemic statistics.

cli, coronavirus, coronavirus-analysis, coronavirus-info, coronavirus-real-time, coronavirus-tracking, covid-19, covid-2019, covid-api, covid-data, covid19, gem, ruby
gem install kovid -v 0.4.9


🦠 Kovid

Kovid is a small CLI app to fetch data surrounding the coronavirus pandemic of 2019. I found myself checking Wikipedia constantly for information and since I work mostly in the terminal, like most of you, I thought I'd build this to put the data right at our fingertips.

Please feel free to contribute or suggest ideas!

⚙️ Installation

Before installing:

☝️ Wash your hands with soap and water for at least 20 seconds.

✌️ Run gem install kovid

After installing:

☝️ Avoid touching your eyes, nose and mouth with unwashed hands later.

✌️ Disinfect your phones, keys, doorknobs and anything you touch often than you should.

⚒️ Usage

You can run kovid --help to see full list of available commands.

Commands Overview


  • kovid check ghana
  • kovid check ghana -f OR kovid check ghana --full


  • kovid compare ghana poland (sorts by cases DESC)
  • kovid compare ghana poland -f OR kovid compare ghana poland --full (sorts by cases DESC)

You can compare as many countries as you want.

Total figures

  • kovid cases

Commands Details

To fetch basic data on a country run:

kovid check ghana

If the location contains spaces: kovid check "Diamond Princess"


For full table info on a country:

kovid check ghana -f OR kovid check ghana --full


To compare country stats:

kovid compare ghana poland


To compare a countries stats with a full table:

kovid compare poland italy usa china -f OR kovid compare poland italy usa china --full


To check for total figures:

kovid cases


👨‍💻 Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

🤲 Contributing

There are multiple areas in this repo that can be improved or use some refactoring and for thats why bug reports and pull requests are welcome here on GitHub. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

🔖 License

The gem is available as open-source under the terms of the MIT License.

❤️ Code of Conduct

Everyone interacting in the Kovid project's codebases and issue trackers is expected to follow the code of conduct.