Bash JSON Viewer — jless & JQ_COLORS

Ketika Anda membutuhkan viewer JSON bash untuk eksplorasi interaktif alih-alih scripting, pipe standar jq . kurang memadai — output bergulir melampaui bagian atas terminal dan Anda tidak memiliki cara untuk menavigasi kembali melalui respons API 300 baris. Panduan ini mencakup alat yang dibangun khusus untuk melihat JSON secara interaktif di terminal: jless (pohon yang dapat diciutkan dengan navigasi tombol vim), JQ_COLORS tema warna kustom, jq -C | less -R paging berwarna, alias shell untuk penggunaan sehari-hari, dan fx sebagai alternatif Node.js. Untuk scripting, CI/CD, dan alur kerja validasi, lihat panduan Format JSON di Bash yang menjadi pasangannya. Untuk viewer browser tanpa instalasi, alat Pemformat JSON bekerja secara instan. Contoh diuji pada Bash 5.x (macOS via Homebrew, Ubuntu 22.04+) dan kompatibel dengan Bash 3.2+ (shell sistem macOS).

Penampilan JSON Interaktif vs. Berbasis Skrip

Mem-pipe JSON ke jq . adalah pilihan tepat saat Anda ingin output terformat untuk payload kecil, atau saat hasilnya diteruskan ke perintah lain. Ini pilihan yang salah saat Anda perlu menjelajahi respons API dengan 200 field — output terbang melampaui jendela terminal dan membuat Anda tidak memiliki cara untuk menavigasi, menciutkan bagian, atau mencari field tertentu tanpa menjalankan ulang perintah dengan filter. Viewer JSON interaktif merender output yang sama — terformat dan berwarna — di dalam pager persisten tempat Anda mengontrol navigasi. Datanya identik; perbedaannya adalah antarmukanya.

# jq . — output scrolls off screen for large responses
curl -s https://api.github.com/users/torvalds | jq .
# 300+ lines scroll past — you lose context immediately

# jless — opens an interactive pager, nothing scrolls off
curl -s https://api.github.com/users/torvalds | jless
# Full document visible, collapsible, searchable with j/k/h/l

jless — Viewer JSON Interaktif

jless adalah viewer JSON terminal yang dibuat khusus. Tidak seperti pipe jq biasa, ia merender dokumen sebagai pohon yang dapat diciutkan secara persisten: setiap objek dan array dapat diperluas atau diciutkan secara independen dengan l dan h, navigasi menggunakan tombol bergaya vim, dan pencarian inkremental menemukan kunci atau nilai apa pun secara instan. Ia melakukan streaming input secara inkremental, sehingga membuka file besar dan respons API dalam waktu kurang dari satu detik tanpa memperhatikan ukuran — di mana jq menyangga seluruh dokumen sebelum menampilkan apa pun. Saya selalu menggunakan jless sebagai alat pertama setiap kali respons API terlalu besar untuk dipindai sekilas.

Instalasi

# macOS
brew install jless

# Linux — prebuilt binary from GitHub Releases
curl -sL https://github.com/PaulJuliusMartinez/jless/releases/latest/download/jless-x86_64-unknown-linux-gnu.tar.gz \
  | tar xz
sudo mv jless /usr/local/bin/

# Verify
jless --version

Penggunaan dasar

# Open a local file — interactive tree viewer launches immediately
jless api-response.json

# Pipe any JSON stream directly into jless
curl -s https://api.github.com/users/torvalds | jless

# Open with all nodes collapsed to top level (useful starting point for large documents)
jless --mode line api-response.json

# Load a specific array element and view it in isolation
jq '.[0]' deployments.json | jless

Navigasi dan pencarian dalam praktik

# Inside jless:
#
#   j / ↓        move down
#   k / ↑        move up
#   l / →        expand node (or Enter)
#   h / ←        collapse node
#   H            collapse current + all siblings → high-level overview
#   L            expand everything recursively
#
#   /            start forward search — type a key name and press Enter
#   n / N        next / previous search match
#
#   g / gg       jump to start
#   G            jump to end
#   q            quit

Referensi Pintasan Keyboard jless

Semua pintasan tersedia segera setelah membuka jless — tidak diperlukan konfigurasi. Model navigasi sengaja dibuat identik dengan vim sehingga kebiasaan otomatis yang sudah ada dapat digunakan.

jq -C | less -R — Paging Berwarna Tanpa Alat Tambahan

Jika jless tidak terinstal dan Anda membutuhkan tampilan berwarna yang dapat di-scroll dari respons JSON, jq -C . | less -R adalah fallback yang mumpuni. Flag -C memaksa kode warna ANSI bahkan saat stdout adalah pipe (biasanya jq menghapusnya), dan -R memberi tahu less untuk merender kode tersebut alih-alih mencetaknya sebagai teks literal. Hasilnya adalah dokumen berwarna penuh yang dapat di-scroll — tanpa struktur pohon interaktif dari jless. Navigasi di dalam less menggunakan tombol panah atau vim-style j/k, dan / memicu pencarian teks bawaan less.

# Basic colorized pager
jq -C . response.json | less -R

# From a curl response — -s prevents progress bar from corrupting the JSON stream
curl -s https://api.github.com/repos/jqlang/jq | jq -C . | less -R

# Sort keys for easier visual scanning, then page
jq -CS . config.json | less -R
# -C = force color, -S = sort keys (both flags combined)

# Add an alias so you never have to type the full pipe again
alias jqv='jq -C . | less -R'
# Usage: cat response.json | jqv
#    or: curl -s https://api.example.com/status | jqv

JQ_COLORS — Tema Warna Kustom

JQ_COLORS adalah variabel lingkungan yang mengganti skema warna ANSI default jq. Ia mengambil string yang dipisahkan titik dua berisi tujuh kode atribut ANSI;warna, satu per tipe JSON dalam urutan tetap ini: null : false : true : angka : string : array : objek. Setiap kode dalam format atribut;warna di mana atribut adalah 0 (normal), 1 (tebal), 2 (redup), atau 4 (bergaris bawah), dan warna adalah nomor warna ANSI standar (30–37 = standar, 90–97 = cerah).

# ANSI color reference for building JQ_COLORS:
#   Attributes:  0=normal  1=bold  2=dim  4=underline
#   Colors:      30=black  31=red  32=green  33=yellow
#                34=blue   35=magenta  36=cyan  37=white
#   Bright:      90=bright-black  91=bright-red  92=bright-green  93=bright-yellow
#                94=bright-blue  95=bright-magenta  96=bright-cyan  97=bright-white
#
# Order: null : false : true : numbers : strings : arrays : objects

# High-contrast theme for dark terminals (recommended)
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=dim-gray, false=bright-red, true=bright-green,
# numbers=bright-yellow, strings=green, arrays=bold-cyan, objects=bold-cyan

# Solarized-style theme
export JQ_COLORS="2;37:0;35:0;35:0;36:0;33:1;34:1;34"
# null=dim-white, false=magenta, true=magenta,
# numbers=cyan, strings=yellow, arrays=bold-blue, objects=bold-blue

# Minimal (bold keys only, everything else plain)
export JQ_COLORS="0;90:0;39:0;39:0;39:0;39:1;39:1;39"

# Add your chosen theme to ~/.bashrc or ~/.zshrc so it applies to every jq call
echo 'export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"' >> ~/.bashrc
source ~/.bashrc

# Test the theme
echo '{"active":true,"errors":null,"count":42,"tags":["api","v2"],"meta":{"version":"1.0"}}' | jq .

Alias Shell untuk Penampilan JSON Sehari-hari

Perintah untuk penampilan JSON interaktif secara default cukup panjang. Sekumpulan alias kecil di ~/.bashrc atau ~/.zshrc menjadikan jless dan paging berwarna sebagai perintah satu kata yang terintegrasi secara alami ke dalam alur kerja apa pun. Alias di bawah ini dapat dikombinasikan — jv dan jvp keduanya menerima input yang di-pipe atau nama file sebagai argumen pertama.

# Add to ~/.bashrc or ~/.zshrc

# jv — interactive viewer (jless if available, colorized pager fallback)
jv() {
  if command -v jless &>/dev/null; then
    jless "$@"
  else
    jq -C . "$@" | less -R
  fi
}

# jvp — view with keys sorted alphabetically (useful for comparing responses)
alias jvp='jq -CS . | less -R'

# jvc — view from clipboard (macOS)
alias jvc='pbpaste | jless'

# jvf — view and filter: jvf '.users[0]' response.json
jvf() {
  local filter="$1"; shift
  jq -C "$filter" "$@" | less -R
}

# Reload without restarting terminal
source ~/.bashrc

# Usage examples after adding aliases above

# View any file or piped response
jv deployment-config.json
curl -s https://api.github.com/users/torvalds | jv

# View sorted (easy to scan alphabetically)
cat feature-flags.json | jvp

# Drill into a sub-document interactively
jvf '.database' infra/app-config.json
jvf '.users[] | select(.role == "admin")' users.json

bat — Penampilan File JSON dengan Sorotan Sintaks

bat adalah pengganti cat dengan sorotan sintaks, nomor baris, dan pager bawaan. Untuk file JSON di disk, ia menyediakan pengalaman membaca yang bersih bergaya editor tanpa membuka editor teks penuh. Tidak seperti jless, bat merender file sebagai teks statis — tidak ada ciutan, tidak ada pencarian, tidak ada navigasi selain scrolling. Kekuatannya adalah kejelasan visual untuk file statis berukuran sedang (konfigurasi, fixture, payload pengujian) di mana Anda ingin warna sintaks dan nomor baris tetapi tidak memerlukan navigasi pohon interaktif.

# macOS
brew install bat

# Debian / Ubuntu (binary may be named batcat)
apt-get install -y bat
# alias bat=batcat   # add to ~/.bashrc if needed on Ubuntu

# View a JSON file with syntax highlighting and line numbers
bat config/feature-flags.json

# Disable pager — print directly to terminal (useful in scripts)
bat --paging=never api-response.json

# Combine with jq: format with jq, view with bat (preserves bat's JSON highlighting)
jq '.' response.json | bat --language=json --paging=never

fx — Penjelajah JSON Interaktif Node.js

fx adalah viewer JSON interaktif yang dibangun di atas Node.js. Antarmukanya mirip dengan jless — pohon yang dapat diciutkan, navigasi keyboard, pencarian — tetapi menambahkan dua fitur yang tidak dimiliki jless: dukungan mouse (klik untuk memperluas/menciutkan node) dan kemampuan mengetikkan ekspresi JavaScript di bilah bawah untuk memfilter dokumen secara real time. Untuk tim yang sudah menjalankan Node.js, fx adalah pilihan yang alami dan tidak memerlukan binary terpisah. Untuk lingkungan terminal murni tanpa Node, jless adalah pilihan yang lebih ramping.

# Install globally via npm
npm install -g fx

# Or run without installing (npx caches the package)
curl -s https://api.github.com/users/torvalds | npx fx

# Basic interactive use
fx api-response.json
curl -s https://api.github.com/repos/jqlang/jq | fx

# In fx: arrow keys navigate, Enter expands/collapses, / searches
# Bottom bar accepts JavaScript expressions for live filtering:
#   .name           → show only the "name" field
#   .repos.slice(0,5) → first 5 repos

# fx also works as a non-interactive formatter (like jq . but with JS syntax)
# Pass a JavaScript expression as argument — no interactive mode
echo '{"users":[{"id":1,"name":"Sarah Chen"},{"id":2,"name":"Marcus Osei"}]}' \
  | fx '.users[0].name'
# Sarah Chen

# Chain with map for array transformations
cat deployments.json | fx '.items.map(d => ({id: d.deploy_id, status: d.state}))'

Kesalahan Umum

Empat kesalahan ini muncul berulang kali saat developer pertama kali mulai menggunakan viewer JSON terminal — masing-masing memiliki solusi yang jelas setelah Anda memahami mengapa hal itu terjadi.

# 300-line API response — top 280 lines immediately scroll off
curl -s https://api.github.com/users/torvalds | jq .
# Only the bottom of the output is visible — cannot navigate back

# Full document stays accessible in jless — nothing is lost
curl -s https://api.github.com/users/torvalds | jless
# j/k to scroll, h/l to collapse/expand, / to search

# Only 6 values — jq silently uses defaults, no indication of why
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96"
echo '{"ok":true}' | jq .  # colors unchanged — no error shown

# Exactly 7 values — 6 colons
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"

# Verify the count before adding to shell profile
echo "$JQ_COLORS" | tr -cd ':' | wc -c   # must output 6

# jless output is for human eyes — piping it produces garbage
jless response.json | grep "request_id"
# Output: ANSI escape codes and cursor sequences, not clean text

# Use jq for programmatic extraction — clean, composable
jq -r '.request_id' response.json | grep "req_"

# Use jless only as the terminal endpoint — nothing after it
jless response.json

# -C without -R: escape sequences print as raw text
jq -C . response.json | less
# Output: ^[[1;34m"status"^[[0m: ^[[0;32m"ok"^[[0m ...

# -C with -R: ANSI codes are rendered as actual colors
jq -C . response.json | less -R
# Output: colorized JSON, clean and readable

jless vs jq vs bat vs fx — Perbandingan Viewer Interaktif

Keempat alat merender JSON berwarna, tetapi kemampuan interaktifnya berbeda secara signifikan. Pilih berdasarkan apakah Anda memerlukan navigasi yang dapat diciutkan, pencarian, atau dukungan mouse — dan apakah Node.js sudah ada di lingkungan Anda.

Untuk sebagian besar situasi: instal jless sekali dan gunakan sebagai viewer interaktif default. Simpan jq -C . | less -R sebagai fallback untuk lingkungan yang tidak dapat menginstal binary tambahan. Tambahkan fx jika tim Anda berbasis Node.js dan menghargai navigasi mouse atau pemfilteran JavaScript langsung.

Pertanyaan yang Sering Diajukan

# Open file in jless, then press / to search
jless api-response.json
# In jless: type /  →  "request_id"  →  Enter  →  n for next match

# jq alternative: extract and print all matching keys to stdout
jq '.. | objects | with_entries(select(.key == "request_id"))' api-response.json

# Open the response in jless
curl -s https://api.github.com/repos/jqlang/jq | jless
# In jless:
#   H            → collapse all top-level keys
#   j/k          → navigate to the key you want
#   l            → expand only that branch
#   gg           → return to root
#   G            → jump to last element

# High-contrast theme for dark terminals — add to ~/.bashrc or ~/.zshrc
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=gray, false=bright-red, true=bright-green,
# numbers=bright-yellow, strings=green, arrays/objects=bright-cyan

# Test immediately without reloading shell
echo '{"active":true,"errors":0,"tags":["api","v2"]}' | jq .

# Small payload — jq . is fine
echo '{"status":"ok","version":"2.4.1"}' | jq .

# Large or nested response — jless is better
curl -s https://api.github.com/repos/jqlang/jq | jless
# → interactive tree, no output scrolled off screen

# Interactive exploration with jless
curl -s https://api.github.com/users/torvalds | jless

# Colorized pager fallback (no collapse, but still scrollable with color)
curl -s https://api.github.com/users/torvalds | jq -C . | less -R

# tmux side-by-side: split horizontally, then run jless in each pane
tmux split-window -h
# Left pane:  jless response-v1.json
# Right pane: jless response-v2.json

# Or use diff on jq-normalized output for a text diff
diff <(jq -S . response-v1.json) <(jq -S . response-v2.json)

Alat Terkait

Alat Pemformat JSON memberikan tampilan yang dapat diciutkan dan berwarna yang sama seperti jless — langsung di browser, tanpa instalasi dan tanpa terminal.