pin

pin

A simple command line pinboard client.

You can add, delete, and list your bookmarks right in your terminal. Incredible.

Usage: pin
  pin rm  URL
  pin add URL [OPTION]
  pin ls [OPTION]

Options:
  -title      title of bookmark being added
  -tag        space delimited tags 
  -private    mark bookmark as private
  -readlater  mark bookmark as read later
  -text       longer description of bookmark
  -l          long format for ls

Install

go get -u github.com/imwally/pin

First: Setup your authentication token

Before running pin you must first create a .pinboard configuration file in your home directory that contains your authentication token. This token can be found on the password tab of the settings page.

Add a bookmark

Adding a bookmark is done by using the add subcommand. It requires one argument -- the page you want to bookmark. The title is automatically copied from the page so there's no need to supply one.

$ pin add http://www.sweetwebsite.com

However, if you prefer to supply your own title you can use the -title flag.

$ pin add http://www.sweetwebsite.com -title "One Sweet Site"

Tagging

Of course you can tag your bookmark as well. Use the -tag flag with space delimited terms.

$ pin add http://www.sweetwebsite.com -title "One Sweet Site" -tag "sweet site cool"

Descriptions

Need even more context for your bookmark? Use the -text flag.

$ pin add http://www.sweetwebsite.com -title "One Sweet Site" \
-tag "sweet site cool" \
-text "I think this is one sweet site so I'm bookmarking it."

More Options

You can also specify the private -private or read later -readlater flags.

Delete a bookmark

The only requirement to delete a bookmark is the URL.

$ pin rm http://www.sweetwebsite.com

If you made a mistake or changed your mind about a recent bookmark you can quickly remove the last bookmark added with the help of pipes (thanks, Douglas McIlroy).

$ pin ls | head -1 | pin rm

Show your bookmarks

You can list the most recent bookmarks.

$ pin ls

If you want more information use the long format -l flag. The private [*] and readlater [#] markers will appear next to the title.

$ pin ls -l

Bookmarks can be filtered by specifying some tags.

$ pin ls -tag "programming unix"

Bookmarks flagged for readlater can also be filtered.

$ pin ls -readlater