Skip to main content

Welcome to jwx

jwx is a fast, beautiful command-line tool for working with JSON Web Tokens. Decode, sign, and inspect JWTs right from your terminal -- or use the web decoder in your browser.

Why jwx?​

Working with JWTs during development often means pasting tokens into browser-based tools that may log or transmit your data. jwx takes a different approach:

  • Just paste and go -- no subcommands needed for the common case. Run jwx <token> and you're done.
  • Beautiful output -- colorized rounded boxes with human-readable timestamps, not a raw JSON dump.
  • Privacy first -- tokens are decoded locally on your machine. Nothing is ever sent to a server.
  • Pipe-friendly -- reads from stdin, supports --json for scripting with jq.

What can jwx do?​

CapabilityDescription
DecodeDisplay JWT header, payload, and signature with colorized, human-readable output
SignCreate tokens with HMAC (HS256/384/512), RSA (RS256/384/512), ECDSA (ES256/384/512), and EdDSA
Expiry detectionAutomatically detects expired tokens and shows relative timestamps
JSON modeMachine-readable output for piping to jq and use in scripts
ClipboardRead tokens directly from your system clipboard
Web decoderA browser-based decoder that runs entirely client-side

Quick example​

# Decode a token -- just paste it
jwx eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

jwx renders a colorized, boxed display showing the header, payload with human-readable timestamps, and signature -- all in your terminal.

Next steps​