node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



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

Default place name

Your last placename will be stored in


Default units

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"

When using Grunt to transpile to javascript

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

#!/usr/bin/env node

White screenshot

White Screenshot

Black screenshot

Black Screenshot

Now you're prepared.