json-tui 0.1.0

A terminal JSON viewer with columnar navigation like JSON Hero

JSON TUI

A terminal JSON viewer with columnar navigation, inspired by JSON Hero.

Features

• Columnar Navigation: Navigate nested JSON structures in a multi-column view
• Keyboard-driven: Vim-style keybindings (hjkl) and arrow keys
• Syntax Highlighting: Color-coded values by type (strings, numbers, booleans, null)
• Live Preview: See full values in the preview panel
• Path Breadcrumbs: Always know where you are in the structure
• Stdin Support: Pipe JSON directly from curl or other commands

Installation

# Clone and install with uv
git clone <repo>
cd json_tui
uv sync

# Or install in development mode
uv pip install -e .

Usage

# View a JSON file
json-tui data.json

# Pipe from stdin
curl https://api.example.com/data | json-tui --stdin

# Or use echo
echo '{"hello": "world", "nested": {"key": "value"}}' | json-tui -s

Keybindings

Key	Action
↑ / k	Move up in current column
↓ / j	Move down in current column
← / h	Focus previous column
→ / l	Focus next column / expand
Enter	Expand selected node
Backspace / Esc	Collapse / go back
?	Show help
q	Quit

Development

# Run directly with uv
uv run json-tui sample.json

# Or activate the venv
source .venv/bin/activate
json-tui sample.json

License

MIT