hl

A fast and powerful log viewer and processor that converts JSON logs or logfmt logs into a clear human-readable format.

Runs as hl|macOS, Linux, Windows|github.com

Command form

ai-draft · 2 tasks · 12 fields

Format JSON or logfmt log files for reading, with level, time and field filters. Follow mode, themes, and tuning options are mostly left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui hl

View logsExample values, fixed in this page — nothing here reaches a terminal

Basic

Log files*

file

Minimum level

errorstring

Use local time zone

--local

TasksEach one presets the form for one job

Show errors only

fileslevellocal

Follow a log

filesfollowlevellocal

ParametersOnly these flags are editable in the form

Log files

Leave empty to read standard input.
path · positional 0 · repeatable

Minimum level

string

--level-lerrorwarninginfodebug

Since

string

--since

Until

string

--until

Field filter

For example level=error or k~=v.
string · repeatable

--filter-f

Query

For example 'status>=400 or duration>=15'.
string

--query-q

Hide field

string · repeatable

--hide-h

Use local time zone

boolean

--local-L

Sort chronologically

boolean

--sort-s

boolean

--follow-F

Pager

enum

--pagingautoalwaysnever

Raw entries

boolean

--raw-r

SourcesEvery flag above is checked against these

help

-s, --sort Sort entries chronologically -F, --follow Follow input streams and sort entries chronologically within time frame set by --sync-interval-ms option -l, --level <LEVEL> Display entries with level >= <LEVEL> [env: HL_LEVEL=] --since <TIME> Display entries with timestamp >= <TIME…

help

github.com

Before it fills your prompt, Otty checks the installed hl against its version. A form that does not match your version is not offered.