Medium for Hackers - 💻 A CLI for Medium Stories.
Latest commit 67a3f97 Dec 29, 2016 @djadmin Fix
Failed to load latest commit information.
.gitignore Added Markdown Rendering Oct 30, 2016 Fix Dec 29, 2016
index.js Fix open url Dec 29, 2016

medium-cli npm version npm npm dep

Medium for Hackers - A CLI for reading Medium Stories.

It helps you read awesome medium articles right in your terminal.


$ npm install -g mediumcli


Usage: medium [options] [command]


top [options]                       List Medium Top Stories
tag [options] <tag>                 List trending Medium Stories by tag
author [options] <author>           List Medium Stories by author
search|s [options] <searchTerms...> Search for stories
read <url>                          Read the story right in your terminal
open [options] <url>                Opens it in your browser


-h, --help     output usage information
-V, --version  output the version number
-o, --open     open story in browser
-m, --markdown render selected story as markdown in the terminal

top [options]
n, --number <int>, specify number of stories

tag [options]
-n, --number <int>  specify number of stories
-l, --latest        get latest instead of trending 

author [options]
-n, --number <int>, specify number of stories

search|s [options] <searchTerms...>
-n, --number <int>  specify number of stories

open [options] <url>
-a, --app <application>  specify app to open the url. Eg: firefox


The commands available are: medium top, medium read, medium open and more..

top command

$ medium top

List Medium Top Stories

$ medium top -n 5

List only top 5 Medium Stories

read command

$ medium read <url>

Read the story right in your terminal

open command

$ medium open <url>

Opens it in your browser

$ medium open -a firefox <url>

Opens it in the given application, like it opens the url using firefox in above example.

Also, you can search by Author, Tags or Keyword

$ medium author _ericelliott

$ medium tag javascript

$ medium tag javascript --latest

$ medium search security

Another Example

$ medium author dheerajhere --open will open the selected story in browser


Feel free to submit issues and enhancement requests.


medium-cli is written in NodeJs and would love to accept pull requests for any issues or feature request.

Read more on contributing.


Copyright (c) 2016 Dheeraj Joshi Licensed under the MIT license.