Skip to content

Latest commit

History

History
111 lines (60 loc) 路 2.39 KB

README.md

File metadata and controls

111 lines (60 loc) 路 2.39 KB

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