Gets the weather for you, and beautifully displays it in your terminal - using the API.


forecast-cli is a CLI tool for getting a beautifully formatted weather forecast in your terminal, using's API. You can configure it to use either degrees Celsius or Fahrenheit.

With npm:

npm install -g forecast-cli

Clone this project:

git clone

Usage: forecast [options] [placename]


--hourly       Hourly report for the next 48 hours
--units        Configure to use Fahrenheit or Celcius (default)
-h, --help     output usage information
-V, --version  output the version number


$ forecast
$ forecast "Cape Town"
$ forecast --hourly "Cape Town"
$ forecast --units

Your last placename will be stored in


The default units are Celcius, and they too are stored in


The available options are

us: Fahrenheit (°F)
si: Celcius (°C)

This file holds your settings. Example:

  "place": "Cape Town",
  "units": "si"

Add the following line to the top of the generated forecast-cli.js file:

#!/usr/bin/env node

Now you're prepared.