Shell Basics

Hidden files require an explicit opt-in:

print -rl -- *        # visible entries
print -rl -- *(D)     # visible and hidden entries
print -rl -- **/*(D)  # recursive, including hidden entries

Useful extended-glob examples:

print -rl -- **/*.js
print -rl -- *(.m-1)
print -rl -- *(Lk+100)

cd /etc
cd /var/log
dirs -v
cd ~1
popd

Because AUTO_PUSHD is active, ordinary cd participates in this stack.

The module replaces any HISTFILE set earlier, for example by Oh My Zsh. To keep history in another location, export ZSH_HISTFILE before sourcing init.zsh:

export ZSH_HISTFILE="${XDG_STATE_HOME:-$HOME/.local/state}/zsh/history"

Create that file’s parent directory first. History is shared across open shells. Commands beginning with a space are omitted, duplicate search results are suppressed, and redundant spaces are reduced before saving.

The global layer is intentionally small:

• case-insensitive filename and command matching
• repeated slash cleanup
• process details for kill <Tab>

Command-specific completion covers the complete public command set:

upkg      npkg       cgm        ztheme     zhelp      tips
extract   peek       mkcd       ff         ft         headers
dusage    bigfiles   fkill      fbr        croot      path
ports     myip       gitcount   fanprofile

npkg and cgm are registered only when their optional commands are available. The definitions understand subcommands, aliases, manager lists, archive suffixes, directories, counts, URLs, and signals. npkg completion may read an existing attribute cache, and cgm completion reads the name-only catalogue. Pressing Tab never runs Nix, refreshes a cache, contacts Secret Service, or retrieves a credential value.

If the parent ~/.zshrc has not run compinit, command-specific completion is not registered. Heavy menu selection, grouped listings, and global coloured completion lists are intentionally omitted because they made completion noticeably slower.

Under the zero-probe startup policy, the built-in ls, ll, and la fallbacks and the grep and diff aliases add automatic color only on Linux. On macOS and BSD they keep the corresponding plain command behavior rather than running capability probes while the shell starts. lsd, when installed, remains the preferred listing backend on every platform where it is available.

gcount deliberately replaces the conflicting Oh My Zsh alias when this layer is sourced afterward.

weather runs a concise forecast request over HTTPS:

weather

It is a lazy function using curl over HTTP/1.1 and does not implement a location argument. weather --help prints usage without making a request.

Global aliases are opt-in because unquoted tokens such as H, T, G, and L expand anywhere in a command line. For example, with aliases enabled, an interactively parsed echo H behaves as echo | head; a filename or search term can become shell syntax. They stay undefined by default. Personal users who want the previous behavior preserve it with one setting before startup:

export ZSH_GLOBAL_ALIASES=1  # in ~/.zshrc, before sourcing init.zsh

Quote a token to keep it literal (echo 'H' prints H). When disabled, zhelp lists these entries as unavailable rather than offering them: