the command line

install

macOS / Linux:

curl -fsSL https://hlog.dev/install.sh | sh

Windows (PowerShell):

irm https://hlog.dev/install.ps1 | iex

with a package manager (updates come with your usual upgrades):

brew install siddharthsingh89/hlog/hlog                                    # Homebrew (macOS, Linux)
scoop bucket add hlog https://github.com/siddharthsingh89/scoop-hlog; scoop install hlog   # Scoop (Windows)

any OS, with Rust installed (crates.io):

cargo install hlog

the installer downloads the right binary from the GitHub releases page, checks its SHA-256 checksum and puts hlog in ~/.local/bin (Windows: %LOCALAPPDATA%\hlog\bin, added to your PATH). you can also download an archive from that page yourself.

log in once

hlog login

it prints a code and a URL (hlog.dev/device). open it while logged in, enter the code, approve. the terminal says "logged in". the CLI shows up in settings → tokens as cli · your-computer.

everyday commands

hlog "shipped the thing"                       # append (levels parsed: hlog "WARN disk full")
hlog learn "advisory locks are session-scoped"  # shortcuts: info debug warn error learn win
echo "from a pipe" | hlog                       # one line per input line, 1 line / 2 s
hlog tail                                       # your recent lines
hlog tail -f --level LEARN                      # keep watching
hlog feed -f                                    # people you tail
hlog grep postgres                              # search your log
hlog review                                     # your week, LEARN and WIN first
hlog everyone -f                                # people who opted in to discovery
hlog search "#rust"                             # search everyone's public lines
hlog feedback "the feed is confusing"           # straight to the person building hlog
hlog save @maya#12                              # privately save someone's line
hlog saved                                      # your saved lines
hlog review --post                              # your week as text to paste into a post
hlog whoami                                     # which account this machine uses
hlog follow @maya --level LEARN
hlog unfollow @maya
hlog sync                                       # send lines queued while offline
hlog logout                                     # revokes the token and forgets it

offline? nothing is lost

if a line can't be sent (no network, hlog is down, you hit the daily limit, or you're logged out), the CLI saves it locally and says "queued". queued lines are sent, oldest first, by hlog sync or automatically before your next line. each one gets its timestamp when it reaches hlog (clients can't set timestamps); the CLI shows when you typed it.

colors only appear in a terminal; set NO_COLOR=1 to turn them off. to log text that starts with a command word: hlog -- tail is a word too.