https://github.com/atalent-labs/human-web-token
🍬 | An opinionated human friendly JWT inspector for your terminal.
https://github.com/atalent-labs/human-web-token
cli dev-exp jwt oidc
Last synced: 9 months ago
JSON representation
🍬 | An opinionated human friendly JWT inspector for your terminal.
- Host: GitHub
- URL: https://github.com/atalent-labs/human-web-token
- Owner: atalent-labs
- License: apache-2.0
- Created: 2023-01-03T03:14:11.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-27T16:46:07.000Z (over 3 years ago)
- Last Synced: 2025-04-05T06:11:37.161Z (about 1 year ago)
- Topics: cli, dev-exp, jwt, oidc
- Language: JavaScript
- Homepage:
- Size: 126 KB
- Stars: 11
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
https://user-images.githubusercontent.com/4768226/211298382-039b09d4-b5cb-4b77-8dce-82f73a9ba714.mp4
## Installation
```sh
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:
### Options
### `--raw` or
```
hwt --raw
```
Result:
### `--claim` or `-c` to filter
If you need to isolate a specific claim you can use the option `--claim`
### 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](https://github.com/vercel/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
- [@olivierodo](https://www.github.com/olivierodo) - 🇫🇷
## License
[MIT License](./LICENSE)