npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

hackclimap

v1.0.0

Published

track your mail, avoid the web clutter

Downloads

9

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

lolodotziplolodotzip

Keywords

Readme

table of contents

compatibility

this project works and can be installed on any device running nodeJS, that being mostly Linux, Windows, and macOS, but it can be installed on Android with terminal emulators for example! compatibility with devices running anything else than macOS, Linux, or Windows has been untested and is gonna be random.

features

this project allows you to do exactly the same stuff you would do on the Hack Club mail portal (mail.hackclub.com), but via your terminal! you can:

  • list your packages, letters,
  • check a certain letter's information (or package),
  • view the global earth map of letters (without lag compared to the web version!!),
  • and you can also view your legacy shipments if you have any associated to your account, but I'm not sure anyone even has any of these.

api endpoints

to use this project, you must first get an API key for hack club mail over here. once you'll first initiate the project, it'll ask you for your API key, and store it in your home directory under the file '.hackCLIMap-apikey.json'. you can edit or reset your API key there!

the hack club mail API is not very well documented, and since it's not very clear on how to use it i'll put the list of endpoints used here, so you may understand better! here's a list of known routes:

  • /api/public/v1/me
  • /api/public/v1/mail (the important one)
  • /api/public/v1/letters
  • /api/public/v1/letters/:id
  • /api/public/v1/packages
  • /api/public/v1/packages/:id
  • /api/public/v1/lsv
  • /api/public/v1/lsv/:type/:id

installation

npm: Linux, macOS, Windows

you can install this project by simply getting it from npm:

npm install -g hackclimap
hackclimap

install from source

to install from source, you must start by making sure you have git, nodeJS, and npm installed. then, start by cloning the repository:

git clone https://github.com/Lolo280374/hackCLIMap.git
cd hackCLIMap

you may then install the dependencies, and link the package to your system:

npm install
npm link

once complete, you can run the following to make sure the installation suceeded, and you can start editing 'index.js' to make modifs!

hackclimap

uninstall

to uninstall, you can simply run the following:

npm uninstall -g hackclimap

reporting issues

this is a community project, and your help is very much appreciated! if you notice anything wrong durign your usage of this project, please report it on the GitHub issues tracker!

privacy disclaimer

this tool dosen't contain any analytics, or software that does connection to third party or online services, excluding the hack club mail API. you can check the source code if you have any doubts, but no analytics are being obtained thru this software!

license

this project is licensed under the MIT license. you can check it here. if you have any questions about this project, please reach me at [email protected].