node package manager


make tweets from your shell


Small node.js cli tool that allows to tweet from bash, zsh, whatever..

Install module globally:

npm install -g node-tweet-cli

You will be able to use tweet command in your shell.

Start with authorizing your twitter account and start tweeting :)

There are description of available commands here:

The tweet login command manages authorization flow. It redirects you to where you need to login and get a PIN. Enter PIN in the terminal prompt and "voilà!" - you are able to tweet from your terminal.

tweet login

The tweet logout command unauthorizes your twitter account from node-tweet-cli.

tweet logout

The tweet create command allows you to post tweets into your twitter account. You will be prompted to type a message.

tweet create

or alias:

tweet new

The tweet read command posts message to twitter but reads it from stdin, enabling use with scripting.

echo "your tweet message" | tweet read


tweet read < yourInputFile

The tweet whoami command shows current twitter account name.

tweet whoami

Streams tweets to the console, optionally as json.

tweet stream twitter


tweet stream twitter --json

Warning The latter option dumps a lot of json in your console. Make sure your console is able to keep up, or (preferably) pipe to another utility. The latter is actually the use case this option is designed for.

Streams your timeline to the console, optionally as json.

tweet timeline


tweet timeline --json
  • tweeting with images

If you have suggestions or found a bug please create an issue here. Thanks!

(c) 2013-2015 MIT License