Skip to content

atalent-labs/human-web-token

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hwt (command line tool)

Description

An opinionated human friendly JWT inspector for your terminal.

Background

Why are we constantly using https://jwt.io/, but actually I don't know about you but personally I just new a few information. But we get overwhelmed by this poor user experience. Adding to this the data privacy... I decided that it was time to stop sharing data with 3rd party and take the controle back of my JWT. 🔥

Demo

demo-hwt.mp4

Installation

curl https://atalent-consulting.com/hwt/install.sh | bash 

Usage

Copy your JWT, we take care of the rest

Actually most of the time when we want to inspect a JWT the first step is to copy it into the clipboard. So... Let's get a good use of that clipboard!

Only run:

hwt

Then from there you will receice the following response:

image

Options

--raw or

hwt --raw

Result:

image

--claim or -c to filter

If you need to isolate a specific claim you can use the option --claim

image

Troubleshooting

If you are running into some issues you can use the environment variable DEBUG.

Example:

DEBUG=hwt hwt

Contribution Development

Surprisingly, this CLI is made with nodejs ^^. We are open to a remake in GO ... Especially knowing since we are using pkg the file is about 50M 😬.

In order to run the code locally you can

  • Install the dependencies: npm i
  • Run the test npm test

Testing

In order to increase the understaing the Unit test has been made through a small framework from scratch leveraging yaml.

Each test are isolated by folder in tests/fixtures

Run the tests

npm test

Run the tests (Watch mode)

npm run test:watch

Author

License

MIT License