Command Reference
45 live entries synced from Nirmal's Shell, with usage docs and feature notes extracted directly from the zsh sources.
45
total commands
18
custom functions
18
entries with extracted details
ls
List directory contents with icons and colors
lsdll
Long listing with hidden files and grouped directories
lsd -lah --group-dirs=firstla
List all files including hidden ones
lsd -Alt
Tree view up to 3 levels deep with grouped directories
lsd --tree --depth=3 --group-dirs=first..
Go up one directory level
cd .....
Go up two directory levels
cd ../......
Go up three directory levels
cd ../../..-
Return to the previous directory
cd -mkdir
Create directories including parent paths automatically
mkdir -pcp
Copy files with interactive confirmation and verbose output
cp -ivmv
Move files with interactive confirmation and verbose output
mv -ivrm
Remove files with interactive confirmation and verbose output
rm -ivcat
Display file contents with syntax highlighting and line numbers
bat --style=numbers --paging=nevergrep
Search text with colorized output
grep --color=autodiff
Compare files with colorized output
diff --color=autoports
Show listening ports and owning processes
portsmyip
Show public IP address over HTTPS
myipweather
Show the current weather forecast
curl --http1.1 -fsSL https://wttr.inglog
Show a compact git history graph
git log --oneline --graph --decorate -20gpr
Pull with rebase for a cleaner git history
git pull --rebasegun
Undo the last commit while keeping changes staged
git reset HEAD~1 --softgcount
Count commits per author
gitcountG
Pipe to grep — use anywhere in a command
| grepL
Pipe to less — use anywhere in a command
| lessW
Count lines — use anywhere in a command
| wc -lH
Show first lines — use anywhere in a command
| headT
Show last lines — use anywhere in a command
| tailNE
Suppress stderr output
2>/dev/nullNUL
Suppress all output (stdout and stderr)
>/dev/null 2>&1extract
Extract any supported archive format automatically
extract <archive>extract <file>ff
Find files by name recursively — uses fd when available
ff <pattern> [path]ft
Find text in files — uses ripgrep when available, falls back to grep
ft <text> [path]ft <pattern> [path]fkill
Fuzzy-select and kill a running process
fkill [signal]headers
Follow redirects and print HTTP response headers
headers <url>peek
Preview a file quickly — uses bat when available
peek <file>dusage
Show disk usage summary for the largest items in a directory
dusage [path] [count]bigfiles
Find the largest files recursively in a directory tree
bigfiles [path] [count]croot
Jump to the root of the current git repository
crootpath
Print each PATH entry on its own line
pathfbr
Fuzzy-pick and checkout a git branch from local or remote refs
fbrnpkg
Nix package manager wrapper — add, remove, find, search, upgrade, and more
npkg <subcommand>npkg <command> [args]Available when nix is installed
Features
- add [pkg ...] Add package(s); with no args opens an fzf picker
- install [pkg ...] Alias for add
- find [query] Fuzzy-pick nixpkgs attribute names and add selections
- search <query> Run a plain nixpkgs search with descriptions
+6 more
Examples
- npkg add bat
- npkg find nvim
- npkg remove
- npkg outdated
+2 more
Notes
- Bare install names are expanded to nixpkgs#<name>
- npkg find searches a cached list of nixpkgs attribute names
- npkg refresh and outdated need jq
- Interactive add/find/remove needs jq and fzf
+1 more
fanprofile
Show the current laptop performance profile
fanprofileupkg
Unified package update/check wrapper across supported managers
upkg [command]upkg [command] [args] [--only <list>] [--skip <list>] [--sudo] [--dry-run]Features
- outdated Show outdated packages across detected managers
- check Alias for outdated
- list Alias for outdated
- search <query> Search package names across detected managers
+6 more
Examples
- upkg # check for outdated packages
- upkg search ripgrep # compare package search matches
- upkg --only brew,npm # check selected managers
- upkg plan # preview upgrades
+3 more
Notes
- Flag: --only <list> Comma-separated manager IDs to include
- Flag: --skip <list> Comma-separated manager IDs to exclude
- Flag: --sudo Allow privileged upgrade backends to run
- Flag: --dry-run Preview upgrades instead of running them
+8 more
gitcount
Show contributor counts for the current repo history
gitcountNotes
- Alias gcount points to gitcount for compatibility
mkcd
Create a directory and cd into it in one step
mkcd <dir>