Functions

The shell config defines only a few functions. They're small and live in stow/common/zsh/. This page covers the ones useful in daily work — the rest are internal plumbing and are intentionally not highlighted.

sizeof

From aliases.zsh. Prints the size of each entry in the current directory:

sizeof

Implementation is du -sh ./* — a quick "what's taking space here?" for the current folder.

chpwd (automatic listing on cd)

Also in aliases.zsh. chpwd is a Zsh hook that runs whenever the working directory changes; here it runs ll, so every cd immediately lists the new directory. You don't call it directly — it fires on navigation.

speed, speed-json, speed-log, speed-history

From speedtest.zsh. Wrappers around cloudflare-speed-cli, which ships no config file — so this layer holds the defaults and the shortcuts:

speed                     # interactive TUI run
speed -4                  # extra flags pass straight through
speed-json | jq '.'       # headless, machine-readable
speed-log                 # silent, for cron/timers — nothing on stdout
speed-history             # export every saved run to one CSV (runs no test)

Defaults are SPEEDTEST_DOWNLOAD_DURATION=10s, SPEEDTEST_UPLOAD_DURATION=10s, and SPEEDTEST_CONCURRENCY=6, all set with : "${VAR:=…}" so ~/.config/zsh/local.zsh or a one-shot environment variable overrides them:

SPEEDTEST_CONCURRENCY=12 speed

speed-log is the one worth scheduling. History belongs to the tool, not to this layer: with --auto-save (default true) every run is written as a JSON file under ${XDG_DATA_HOME:-$HOME/.local/share}/cloudflare-speed-cli/runs/, and speed-history exports that whole set to a single CSV. The layer is guarded by command -v cloudflare-speed-cli, so the functions simply do not exist on a machine without the tool.

Measures the path to Cloudflare

Results describe your connection to the Cloudflare anycast edge and are not directly comparable to Ookla Speedtest figures. The tool also has no theme options, so it is the one integration that does not follow the Catppuccin Macchiato palette.

Saved runs contain identifying data

Each saved run records your public IP, ISP, region, local IP, and interface MAC. Keep those files where they are — never paste them into an issue or a repository.

Internal helpers (not for direct use)

These exist for the config's own wiring and aren't meant to be called by hand:

Function	File	Role
path_prepend / path_append	path.zsh	Add directories to PATH safely during shell init
_herdr / _herdr_sessions	herdr.zsh	Zsh completion plumbing for Herdr session names

Deliberately minimal

The setup leans on aliases and tool integrations rather than a large library of custom functions. Anything more personal or machine-specific belongs in your own untracked ~/.config/zsh/local.zsh (see Shell).