Skip to content

All Functions ​

Every shell function organized by category - comprehensive reference with descriptions.

Git ​

Interactive Git Operations ​

FunctionDescription
git_current_branchGet current branch name (helper for other funcs)
gaddInteractive git add with fzf and preview
gcoInteractive branch checkout with fzf
glogInteractive log browser with fzf preview
gstashInteractive stash manager (apply/pop/drop/show)
grebaseInteractive rebase helper with fzf selection
gstatusEnhanced status output (grouped by type)

Git Push ​

FunctionDescription
gpnSmart push: HEAD:<branch> to origin with --no-verify
gpn -f — force push with --force-with-lease
gpn -u — set upstream and push

Git Utilities ​

FunctionDescription
gsetupInitialize repo with sensible defaults
gcleanClean merged branches and prune remotes

Git Worktree Manager ​

FunctionDescription
gwtFull-featured git worktree manager with fzf
Commands:
gwt list [--date] - Show all worktrees
gwt switch - Fuzzy-find and switch to worktree
gwt new <branch> - Create new worktree
gwt remove - Remove worktree(s)
gwt clean - Prune stale worktrees
gwt info - Show current worktree details

Git Iris Integration ​

FunctionDescription
gprGenerate PR description from commits
gprcGenerate PR description and copy to clipboard

Directory Navigation ​

Basic Navigation ​

FunctionDescription
mkcdCreate directory and cd into it
takeMulti-arg version of mkcd
upGo up N directories (default: 1)

Smart Navigation ​

FunctionDescription
devInteractive project picker for ~/dev/ (fzf)
fcdInteractive directory navigation with fzf
zpZoxide with pushd/popd semantics
zp <query> - Jump and push to stack
zp -p/--pop - Pop from stack
zp -l/--list - List directory stack
zp -c/--clear - Clear stack

Bookmarks ​

FunctionDescription
markCreate bookmark for current dir
unmarkRemove bookmark by name
marksList all bookmarks
jumpJump to bookmark (interactive if no arg)

Directory Analysis ​

FunctionDescription
duhSorted directory sizes (human-readable)
dvInteractive directory size viewer with fzf
mktreeCreate directory and show tree view
ffFind files by name pattern

Docker ​

Interactive Docker Functions ​

FunctionDescription
dexecInteractive container exec with fzf
dlfInteractive container logs with follow
dstopiInteractive container stop (multi-select)
drmiInteractive remove stopped containers

Docker Utilities ​

FunctionDescription
dipGet container IP address
dcrDocker Compose restart with fzf
dstatsContainer resource stats (formatted)
dcleanFull Docker cleanup (system/volumes/networks)

Kubernetes ​

FunctionDescription
kconfigSwitch kubeconfig file
klogsQuick pod logs with follow
khelpKubernetes commands cheatsheet
k9cInteractive k9s cluster picker (fzf + kubectx)
sopseInteractive SOPS encrypted file editor (fzf)

TypeScript & Monorepo ​

Turbo Filter Shortcuts ​

FunctionDescription
tdfturbo dev --filter
tbfturbo build --filter
tcfturbo typecheck --filter
ttfturbo test --filter

TypeScript Runners ​

FunctionDescription
tsRun TypeScript file with tsx
tswRun TypeScript file in watch mode

Monorepo Navigation ​

FunctionDescription
monoInteractive monorepo package navigator
monolsList all workspace packages with info
ts-infoDisplay project info (Node/TS/tooling)

Node.js ​

Version Management ​

FunctionDescription
node-ltsInstall and use latest LTS Node
node-latestInstall and use latest stable Node
node-switchInteractive version picker with fzf
node-listList installed Node versions
node-installInstall specific Node version
node-uninstallUninstall Node version
node-infoShow current Node/npm/nvm versions

nvmrc Support ​

FunctionDescription
auto-nvmUse .nvmrc in current directory
nvmrc-createCreate .nvmrc with current version

Python ​

Virtual Environments ​

FunctionDescription
venvCreate and activate virtual environment
vaAuto-find and activate venv (searches up)
vdDeactivate current virtual environment

Django ​

FunctionDescription
drsDjango runserver (default: port 8000)
dshDjango shell (shell_plus if available)
dmmDjango makemigrations
dmDjango migrate
dsuDjango createsuperuser
dtDjango test

Testing & Formatting ​

FunctionDescription
ptRun pytest with verbose output
ptdRun pytest with debug logging
formatFormat code with black + isort

Rust ​

FunctionDescription
caddAdd dependency with cargo-edit
cwatchWatch and rebuild with cargo-watch
rswitchInteractive toolchain switcher with fzf
crtreeInteractive dependency tree viewer

Java ​

FunctionDescription
setjdkSwitch Java version
list_java_versionsShow available Java installations

System Info ​

Overview ​

FunctionDescription
sysFull system information dashboard
sysinfoBasic system information
healthQuick health check (CPU/mem/disk)

Components ​

FunctionDescription
cpuinfoCPU details and usage
meminfoMemory usage and statistics
diskinfoDisk usage for all mounts
gpuinfoGPU information (if available)
batteryBattery status (laptops)
tempsSystem temperatures
servicesService status

Network ​

FunctionDescription
portShow what's using a specific port
portsList all listening ports
netcheckConnectivity test (ping common hosts)
netifShow active network interfaces
connectionsShow active network connections
bandwidthMonitor bandwidth usage
wifiWiFi information (macOS)

Process Management ​

FunctionDescription
pmeShow my processes
ptreeProcess tree view
pwatchLive process monitoring
pfindFind processes by name
pkKill processes by pattern
pmemTop processes by memory usage
pcpuTop processes by CPU usage

macOS Specific ​

File Operations ​

FunctionDescription
finderOpen current directory in Finder
clipCopy to clipboard
qlQuick Look preview
copy-pathCopy file path to clipboard

System Utilities ​

FunctionDescription
wifi-nameShow current WiFi SSID
list-devicesList USB/Bluetooth/Thunderbolt devices
extract-dmgMount and extract DMG contents
unquarantineRemove quarantine attribute
toggle-dark-modeSwitch between dark/light mode
set-volumeSet system volume
brew-servicesInteractive Homebrew service manager

Screenshots ​

Multiple screenshot functions for various capture modes (see source for details).

FZF Interactive Tools ​

FunctionDescription
fopenOpen file in editor with preview
fkillKill processes interactively
fenvSearch environment variables
frgRipgrep search with file opening
fdockerDocker container selector and exec

History ​

The history helpers live in sh/atuin.sh.

FunctionDescription
hfail [query] [limit]Find failed user commands in this workspace
hlast [query]Recall the last successful user command in this directory
hstats [period] [count]Show command usage stats
hagents [query] [limit]Find commands recorded by agent hooks

Homebrew ​

FunctionDescription
bupBrew update + upgrade with preview before confirming

Shell Utilities ​

Detection Functions ​

FunctionDescription
is_zshCheck if running in Zsh
is_bashCheck if running in Bash
is_macosCheck if running on macOS
is_linuxCheck if running on Linux
is_wslCheck if running in WSL
has_commandCheck if command exists
is_minimalCheck if server install
is_fullCheck if desktop install

Helper Functions ​

FunctionDescription
safe_sourceSource file with error handling
extractExtract various archive formats
ftextSearch file contents
psgFind process by name (grep ps)

Released under the MIT License