Skip to content

DocsΒΆ

🎯 Filters¢

Docs

156Files
8Categories
193Tags
58,680LOC

Auto-generated from source headers on every build β€” env vars, usage, deps, exit codes, and Mermaid graphs.

πŸ§œβ€β™€οΈ Call-tree Diagram 🧰 Auxiliary Scripts
πŸ“Š Sort Categories
🏷️ Filter by Tag156 filesSelectShow
πŸ’» cli59 πŸ’» bin33 πŸ”§ utility30 πŸ”§ shared21 ⌨️ widget21 ⌨️ keybinding21 πŸ“ logging20 ⌨️ zle20 πŸš€ bootstrap19 πŸš€ startup16 βš™οΈ config13 🧱 core12 πŸ“‹ clipboard11 πŸͺ hook10 πŸ”„ sync9 πŸ”Œ integration9 πŸ›€οΈ path8 πŸ”€ git8 cloud7 πŸ” fzf7 βš™οΈ env6 πŸ›‘οΈ audit6 πŸ—οΈ framework6 πŸ”„ rebuild6 πŸ“ io5 πŸ“‚ file5 πŸ› debug5 πŸ§ͺ testing5 πŸ”¨ build5 ⏱️ timing4 πŸ› diagnostics4 pin4 🎯 context4 πŸ”„ compile4 🎨 theme4 πŸ“¦ bundle4 πŸ§ͺ assert3 βœ… validation3 ⚑ zwc3 πŸ“‹ copy3 πŸ“Œ paste3 🧹 json3 πŸ–₯️ wayland3 ⚑ alias3 🧹 cleanup3 πŸ” search3 🩺 health3 πŸŽ›οΈ options3 ❓ help3 ✏️ editor3 πŸ’¬ completions3 πŸ’€ lazy3 πŸ“„ toml3 πŸ“‘ monitor3 πŸ€– ai3 πŸ“š docs3 πŸ“₯ import3 🚨 stderr2 πŸ”— compat2 🦺 safe-mode2 πŸ“’ stdout2 πŸ—„οΈ cache2 πŸ“‚ xdg2 πŸ“₯ autoload2 πŸ“₯ loading2 πŸ“„ source2 πŸ“¦ functions2 πŸ—ƒοΈ archive2 πŸ“ template2 🌿 branch2 🧹 jq2 πŸ“¦ packages2 🐚 zsh2 πŸ”‘ ssh2 🦺 safety2 πŸ“– reference2 πŸ“Š dashboard2 🌐 network2 πŸ“œ history2 πŸ“ zoxide2 🧬 vars2 🧰 mise2 πŸ›€οΈ fpath2 ⌨️ keybindings2 πŸ“₯ loader2 🧩 omz2 🐚 atuin2 πŸ“‚ chpwd2 πŸ“Š perf2 🎨 p10k2 ⚑ recompile2 πŸ“ˆ profile2 πŸ”’ private2 πŸ”’ internal2 πŸ“Έ screenshot2 🧭 navigation2 πŸ”ƒ diff2 πŸ’Š system2 🍬 gum1 πŸ“Ί tui1 🚨 error1 ⚠️ warn1 πŸš€ init1 πŸ’‘ info1 βœ… ok1 ⏲️ millis1 πŸ“ dir1 πŸ“¦ function1 πŸ”„ compilation1 πŸ“’ echo1 πŸ“Š result1 πŸ§ͺ eval1 πŸƒ runner1 πŸ”‡ quiet1 detection1 βž• prepend1 error-handling1 πŸ“‚ pwd1 πŸ“¦ extract1 πŸ“¦ unpack1 πŸ†• create1 πŸ”§ wrapper1 🌐 browser1 🌐 url1 ↩️ undo1 πŸ“œ reflog1 βœ… check1 🧹 format1 πŸ“Š stats1 πŸ”ƒ dedup1 interactive1 mirror1 πŸ” rg1 πŸ”˜ toggle1 🌐 remote1 unpin1 πŸ’Ύ backup1 πŸ“Š table1 πŸ“œ bootlog1 πŸ”¬ inspect1 🌐 ports1 πŸ” lsof1 πŸ“‘ monitoring1 πŸ’¬ commit1 πŸ’₯ expand1 πŸ“ buffer1 πŸ“¦ cargo1 πŸ” fd1 πŸ“– man1 πŸ†• scratch1 πŸ”“ sudo1 πŸ”‘ password1 βš™οΈ engine1 πŸƒ zrun1 πŸ›‘οΈ integrity1 ⚑ aliases1 ⌨️ widgets1 πŸͺ hooks1 🚨 critical1 🧩 plugins1 ⏱️ runtime1 🏷️ version1 πŸ•΅οΈ agent1 πŸ›‘οΈ security1 🐳 docker1 πŸ“‚ cd1 πŸ“ˆ frecency1 ☁️ wrangler1 ☁️ cloudflare1 πŸͺͺ identity1 🐧 arch1 πŸ“Έ screenshots1 πŸ“‹ wl-copy1 πŸ”§ dev1 πŸ’» vscode1 πŸ“Ί terminal1 deactivation1 πŸ•΅οΈ stale1 🧰 tools1 🦺 recovery1 🚦 sentinel1 πŸ”— links1 ⚑ trigger1 πŸ—ΊοΈ project1 rclone1 pueue1 headers1 🧩 plugin1 🧩 prezto1 πŸ”— link1 πŸ—οΈ scaffold1 πŸ“Έ snapshot1 ⬆️ update1

🧱 Core Modules¢

🧱 Core Modules (11) 11/11
NameTitlePurposeLOCDEPSTags
🧬 02_varsCore Variables & Identity BootstrapFirst file in the load sequence. Establishes ZSHAND and PROJECT_ROOT, XDG3562🧱 core βš™οΈ config πŸš€ bootstrap 🧬 vars πŸ“‚ xdg
πŸ›€οΈ 04_pathPATH Construction & Runtime Setup221🧱 core πŸ›€οΈ path βš™οΈ config βš™οΈ env 🧰 mise
βš™οΈ 06_engineHigh-Performance Execution Engine & Bootstrapper805🧱 core βš™οΈ engine πŸ”„ compile πŸ“ logging πŸƒ zrun
πŸ›‘οΈ 08_auditSystem Integrity & Telemetry Auditing385🧱 core πŸ›‘οΈ audit πŸ“ logging πŸ›‘οΈ integrity
πŸŽ›οΈ 10_optionsShell Behavior, History, and UI Ergonomics180🧱 core πŸŽ›οΈ options βš™οΈ config 🐚 zsh
πŸ’¬ 12_completionsHigh-Performance Completion & Visual Menu Selection388🧱 core πŸ’¬ completions βš™οΈ config πŸ›€οΈ fpath
⚑ 14_aliasesHigh-Velocity Shortcuts & Context-Aware Wrappers344🧱 core ⚑ aliases βš™οΈ config πŸ—οΈ framework
🎹 16_widgetsLazy-Loaded ZLE Widgets & Unified Keyboard Map451🧱 core ⌨️ widgets ⌨️ keybindings πŸ’€ lazy πŸ“„ toml
πŸͺ 18_hooksHook Classification & Lazy Loading Configuration3221🧱 core πŸͺ hooks πŸ“₯ loader 🚨 critical πŸ’€ lazy
🧩 20_pluginsModular Plugin System with Load Strategy Control63211🧱 core 🧩 plugins 🎨 theme πŸ’€ lazy 🧩 omz
πŸ“¦ 90_functionsHigh-Performance Dynamic Function Loader with Priority Sy…279🧱 core πŸ“₯ loader πŸ“¦ functions πŸ“₯ autoload πŸ›€οΈ fpath

🏁 Startup Scripts¢

🏁 Startup Scripts (16) 16/16
NameTitlePurposeLOCDEPSTags
πŸ”§ 05_az_dev_mode_checkOptional Rebuild When Stale (Dev Mode Only)When dev mode and auto-rebuild are enabled, detects stale framework1192πŸš€ startup πŸš€ bootstrap πŸ”§ dev πŸ”„ rebuild
πŸ’» 14_az_vscode_integrationVSCode Terminal Integration761πŸš€ startup πŸš€ bootstrap πŸ’» vscode πŸ“Ί terminal
πŸ“‹ 15_az_wayland_clipboardWayland Clipboard & cliphist Daemon80πŸš€ startup πŸš€ bootstrap πŸ–₯️ wayland πŸ“‹ clipboard
πŸ“„ 16_az_load_toml_configParse config.toml into ZSHAND_* Variables219πŸš€ startup βš™οΈ config πŸ“„ toml πŸš€ bootstrap 🧬 vars
⌨️ 17_az_bindkey_from_tomlApply keybindings from keybindings.toml134πŸš€ startup πŸš€ bootstrap ⌨️ keybindings πŸ“„ toml
βš™οΈ 18_az_package_deactivationExport Package Deactivation Env VarsLoads packages.toml (framework + user) early in startup and exports1221πŸš€ startup πŸ“¦ packages deactivation βš™οΈ config πŸš€ bootstrap
πŸ•΅οΈ 19_az_zwc_stale_checkDetect When Bundle Recompile Is Needed136πŸš€ startup πŸš€ bootstrap ⚑ zwc πŸ•΅οΈ stale πŸ”„ compile
⏱️ 20_az_debug_timing_summaryPrint Init Timing Table (ZSHAND_DEBUG=1)281πŸš€ startup πŸš€ bootstrap πŸ› debug ⏱️ timing
🩺 21_az_health_validate_toolsEnsure Critical CLI Tools Exist106πŸš€ startup πŸš€ bootstrap 🩺 health 🧰 tools
πŸ“Š 22_az_perf_budget_warnWarn When Files Exceed ZSHAND_PERF_BUDGET75πŸš€ startup πŸš€ bootstrap πŸ“Š perf ⏱️ timing
🎨 23_az_theme_restore_p10kSource .p10k.zsh and Record Theme Timing1101πŸš€ startup πŸš€ bootstrap 🎨 theme 🎨 p10k
🦺 24_az_safe_modeFailure Detection, Minimal Shell, and Recovery Menu1401πŸš€ startup πŸš€ bootstrap 🦺 safe-mode 🦺 recovery
🚦 25_az_startup_sentinelPost-Init: zprime Status, Recompile Notice, Log107πŸš€ startup πŸš€ bootstrap 🚦 sentinel ⚑ recompile
πŸ”— 26_az_create_reference_linksCreate Symlinks to Key Framework Files121πŸš€ startup πŸš€ bootstrap πŸ”— links πŸ“– reference
πŸ”„ 27_az_background_recompileZero-Cost Background ZWC Maintenance164πŸš€ startup πŸš€ bootstrap ⚑ recompile ⚑ zwc
πŸ“ˆ 28_az_profile_full_triggerAuto-trigger Full Profiling Mode1182πŸš€ startup πŸš€ bootstrap πŸ“ˆ profile ⚑ trigger

πŸ”§ Shared FunctionsΒΆ

πŸ”§ Shared Functions (21) 21/21
NameTitlePurposeLOCDEPSTags
🍬 00_gum_ioRed Error Message to stderrSingle source of truth for all terminal IO in the Zsh runtime layer.516πŸ”§ shared πŸ“ io 🍬 gum πŸ“ logging πŸ“Ί tui
🚨 01_stderr_errorRed Error Message to stderrDEPRECATED: This file is a backward-compatibility stub.76πŸ”§ shared πŸ“ logging 🚨 stderr 🚨 error πŸ”— compat
⚠️ 02_stderr_warnYellow Warning Message to stderrDEPRECATED: This file is a backward-compatibility stub.76πŸ”§ shared πŸ“ logging 🚨 stderr ⚠️ warn πŸ”— compat
πŸ“ 03_init_log_appendAppend Timestamped Line to init.logAppend timestamped entries to framework init log. Suppressed when90πŸ”§ shared πŸ“ logging πŸš€ init πŸš€ bootstrap 🦺 safe-mode
πŸ’‘ 04_echo_infoCyan Info Message (stdout)41πŸ”§ shared πŸ“ io πŸ“ logging πŸ“’ stdout πŸ’‘ info
βœ… 05_echo_okGreen Success Message (stdout)41πŸ”§ shared πŸ“ logging πŸ“ io πŸ“’ stdout βœ… ok
⏲️ 06_time_millisHigh-Resolution Timestamp in Milliseconds89πŸ”§ shared πŸ“ logging ⏱️ timing πŸ”§ utility ⏲️ millis
πŸ—„οΈ 07_cache_dirPrint Framework Cache Directory Path52πŸ”§ shared πŸ—„οΈ cache πŸ›€οΈ path πŸ“‚ xdg πŸ”§ utility
πŸ“‚ 08_assert_dir_existsCheck Directory Exists (with optional ZSHAND_DEBUG)71πŸ”§ shared πŸ§ͺ assert πŸ›€οΈ path πŸ“ dir βœ… validation
πŸ“„ 09_assert_file_existsCheck File Exists (with optional ZSHAND_DEBUG)72πŸ”§ shared πŸ§ͺ assert πŸ›€οΈ path πŸ“‚ file βœ… validation
πŸ” 10_assert_function_existsCheck Function Is Defined71πŸ”§ shared πŸ§ͺ assert πŸ“¦ function βœ… validation πŸ“₯ autoload
⚑ 11_source_with_zwcSource .zsh with Native .zwc Auto-Discovery99πŸ”§ shared πŸ“₯ loading ⚑ zwc πŸ”„ compilation πŸ“„ source
πŸ› 12_debug_echo_cmdPrint Command Description (ZSHAND_DEBUG only)58πŸ”§ shared πŸ“ logging πŸ› debug πŸ§ͺ testing πŸ“’ echo
πŸ”¬ 13_debug_echo_resultPrint Result Line (ZSHAND_DEBUG only)39πŸ”§ shared πŸ“ logging πŸ› debug πŸ§ͺ testing πŸ“Š result
πŸ§ͺ 14_debug_eval_testRun Test, Print Result (ZSHAND_DEBUG only)46πŸ”§ shared πŸ“ logging πŸ› debug πŸ§ͺ testing πŸ§ͺ eval
⏳ 15_load_file_timedLoad .zsh with Timing, Logging, Perf Tracking87πŸ”§ shared πŸ“ logging ⏱️ timing πŸ“₯ loading πŸ“„ source
πŸƒ 16_zrun1381πŸ”§ shared πŸ“ logging πŸ’» cli πŸƒ runner πŸ”‡ quiet
πŸ“‹ 17_clipboard_copyEnterprise-Grade Cross-Platform Clipboard CopyProvides robust, fault-tolerant clipboard copy across all platforms with335πŸ”§ shared πŸ“ logging πŸ“‹ clipboard πŸ“ io πŸ“‹ copy
πŸ“Œ 18_clipboard_pasteEnterprise-Grade Cross-Platform Clipboard PasteProvides robust, fault-tolerant clipboard paste across all platforms with326πŸ”§ shared πŸ“ logging πŸ“‹ clipboard πŸ“ io πŸ“Œ paste
πŸ” 19_json_escapeEscape String for JSON26πŸ”§ shared 🧹 json πŸ”§ utility
πŸ”§ 20_detect_cloud_mountCloud Remote Directory DetectorDetects which configured cloud remote a directory belongs to. Reads106πŸ”§ shared cloud detection πŸ”§ utility

πŸ”— HooksΒΆ

πŸ”— Hooks (10) 10/10
NameTitlePurposeLOCDEPSTags
🧰 01_misePolyglot Runtime Manager with Cached ActivationInitializes mise (formerly rtx) for multi-version runtimes (Node, Python,2291πŸͺ hook πŸ”Œ integration ⏱️ runtime 🧰 mise 🏷️ version
🐚 02_atuinCloud-Synced Command History with Intelligent SearchInitializes Atuin: cloud sync, Ctrl+R fuzzy search, statistics. Cached2241πŸͺ hook πŸ”Œ integration πŸ“œ history 🐚 atuin πŸ” search
πŸ”‘ 05_ssh-agentUnified SSH Agent Manager with Systemd Socket DetectionEnsures an SSH agent is available for git/ssh: prefers existing1713πŸͺ hook πŸ”Œ integration πŸ”‘ ssh πŸ•΅οΈ agent πŸ›‘οΈ security
🐳 20_dockerLazy-Loaded Docker Setup with Group ValidationDefers Docker setup until first use: no startup cost. On first `docker`126πŸͺ hook πŸ”Œ integration 🐳 docker πŸ’¬ completions
πŸ“ 30_zoxideFrecency-Based Smart Directory JumperInitializes zoxide for smart cd: frecency (frequency + recency) scoring,1501πŸͺ hook πŸ”Œ integration πŸ“ zoxide πŸ“‚ cd πŸ“ˆ frecency
☁️ 40_wranglerCloudflare Workers CLI IntegrationLoads Wrangler CLI completions (cached to avoid subprocess each startup)1331πŸͺ hook πŸ”Œ integration ☁️ wrangler πŸ’¬ completions ☁️ cloudflare
πŸͺͺ 50_gitidAutomatic Project-Specific Git Identity SwitcherChpwd hook that sets git user.name, user.email, and optional core.sshCommand238πŸͺ hook πŸ”Œ integration πŸ”€ git πŸͺͺ identity πŸ“‚ chpwd
πŸͺ 55_cloud_chpwdCloud Folder Safety WarningChpwd hook that warns when entering an unpinned cloud-only directory.69πŸͺ hook cloud πŸ“‚ chpwd 🦺 safety
🧹 80_archcleanAutomatic Screenshot Archive CleanupRuns once at shell init: removes screenshot tarballs in118πŸͺ hook πŸ”Œ integration 🧹 cleanup 🐧 arch πŸ“Έ screenshots
🧼 81_wlcleanWayland Clipboard Daemon Cleanup & Error SuppressionOn Wayland only (XDG_SESSION_TYPE=wayland): kills orphaned wl-copy130πŸͺ hook πŸ”Œ integration πŸ–₯️ wayland πŸ“‹ clipboard πŸ“‹ wl-copy

⚑ Functions¢

⚑ Functions (31) 31/31
NameTitlePurposeLOCDEPSTags
βž• add_pathPlatinum Path Manager156πŸ’» cli πŸ”§ utility πŸ›€οΈ path βž• prepend βš™οΈ env
πŸ“œ bootlogShell Initialization Log Viewer170πŸ’» cli πŸ”§ utility πŸ“ logging πŸš€ bootstrap πŸ› diagnostics
πŸ“‚ command_not_foundSmart Command-Not-Found Handler with PATH Healing91🧱 core πŸ›€οΈ path πŸ“¦ functions error-handling
πŸ“‘ dcopyCopy Current Directory Path to Clipboard102πŸ’» cli πŸ”§ utility πŸ“‹ clipboard πŸ–₯️ wayland πŸ“‚ pwd
πŸ“¦ extractUniversal Archive Extractor159πŸ’» cli πŸ”§ utility πŸ—ƒοΈ archive πŸ“¦ extract πŸ“¦ unpack
πŸ“Ž fcopyCopy File Contents to Clipboard (Wayland)118πŸ’» cli πŸ”§ utility πŸ“‚ file πŸ“‹ copy πŸ“ template
πŸ†• fnewCreate New Function Stub139πŸ’» cli πŸ”§ utility πŸ“‚ file πŸ†• create πŸ“ template
πŸ”€ gitSmart Git Wrapper with Auto SSH Identity Selection208πŸ’» cli πŸ”§ utility πŸ”€ git πŸ”§ wrapper ⚑ alias
βœ‚οΈ gitpruneDelete Merged Local Branches160πŸ’» cli πŸ”§ utility πŸ”€ git 🌿 branch 🧹 cleanup
πŸ”Ž googleWeb Search Integration140πŸ’» cli πŸ”§ utility πŸ” search 🌐 browser 🌐 url
↩️ gundoGit Undo / Safety Valve202πŸ’» cli πŸ”§ utility πŸ”€ git ↩️ undo πŸ“œ reflog
🩺 healthSystem Health Check215πŸ’» cli πŸ”§ utility 🩺 health πŸ› diagnostics βœ… check
🧹 jfmtPretty-Print JSON114πŸ’» cli πŸ”§ utility 🧹 json 🧹 format 🧹 jq
πŸ“Š logstat30-Day Log Statistics152πŸ’» cli πŸ”§ utility πŸ“ logging πŸ“Š stats πŸ› diagnostics
πŸ› οΈ pathfixPATH Audit and Repair177πŸ’» cli πŸ”§ utility πŸ›€οΈ path πŸ”ƒ dedup 🧹 cleanup
πŸ”„ pinInteractive Cloud Sync Pin MenuInteractive wrapper for pin_mirror and pin_cache. Presents a strategy87cloud pin interactive πŸ”„ sync
πŸ”„ pin_cacheCreate Cache Pin for Cloud SyncCreates or updates a .cloud-pin file with a cache (VFS pre-heat) target122cloud pin πŸ—„οΈ cache πŸ”„ sync
πŸ”„ pin_mirrorCreate Mirror Pin for Cloud SyncCreates or updates a .cloud-pin file with a mirror (bisync) target for the124cloud pin mirror πŸ”„ sync
πŸ“₯ pkgsyncPackage Sync Check2651πŸ’» cli πŸ”§ utility πŸ”„ sync πŸ“¦ packages πŸ›‘οΈ audit
πŸ” seekSearch Across ZSHAND Files136πŸ’» cli πŸ”§ utility πŸ” search πŸ” rg βš™οΈ config
πŸ”˜ togZsh Option Toggle Utility116πŸ’» cli πŸ”§ utility πŸŽ›οΈ options πŸ”˜ toggle 🐚 zsh
πŸ”‘ tosshConvert Git Remotes from HTTPS to SSH135πŸ’» cli πŸ”§ utility πŸ”€ git πŸ”‘ ssh 🌐 remote
πŸ”„ unpinRemove Cloud Sync PinRemoves a sync target from a .cloud-pin file, or removes the entire pin116cloud pin unpin πŸ”„ sync
πŸ’Ύ zbakTimestamped Backup Creation136πŸ’» cli πŸ”§ utility πŸ’Ύ backup πŸ“‚ file 🦺 safety
❓ zhelpZSHAND Master Reference99πŸ’» cli πŸ”§ utility πŸ“– reference ❓ help πŸ“Š table
πŸ“ zlogSession Log Viewer207πŸ’» cli πŸ”§ utility πŸ“ logging πŸ“œ bootlog πŸ› diagnostics
βš™οΈ zoptZsh Options Lister with Filtering128πŸ’» cli πŸ”§ utility πŸŽ›οΈ options βš™οΈ config πŸ”¬ inspect
πŸ›€οΈ zpathPATH and fpath Auditor94πŸ’» cli πŸ”§ utility πŸ›€οΈ path πŸ“Š dashboard πŸ›‘οΈ audit
🌐 zportsNetwork Port Listener Inspection149πŸ’» cli πŸ”§ utility 🌐 network 🌐 ports πŸ” lsof
πŸ“ˆ ztopWorkstation Dashboard156πŸ’» cli πŸ”§ utility πŸ“Š dashboard πŸ“‘ monitoring 🩺 health
🎹 zwidgetsKeyboard Map / Widget Reference90πŸ’» cli πŸ”§ utility ⌨️ widget ❓ help ⌨️ keybinding

⌨️ Widgets¢

⌨️ Widgets (20) 20/20
NameTitlePurposeLOCDEPSTags
πŸ€– aicmitAI-Assisted Git Commit Message GeneratorZLE widget: builds AI commit prompt from project context, staged diff, and265⌨️ widget ⌨️ zle ⌨️ keybinding πŸ”€ git πŸ’¬ commit
🧠 aidebugAI-Assisted Command Debugger & OptimizerZLE widget: builds AI diagnostic prompt from BUFFER and last command output175⌨️ widget ⌨️ zle ⌨️ keybinding πŸ› debug πŸ§ͺ testing
πŸ”€ aliasfFind Aliases for Current Command (FZF)117⌨️ widget ⌨️ zle ⌨️ keybinding ⚑ alias πŸ” fzf
πŸ’₯ aliexpExpand Alias In-Place79⌨️ widget ⌨️ zle ⌨️ keybinding ⚑ alias πŸ’₯ expand
🌿 bpickBinary/Executable Picker (FZF, Path-Aware)107⌨️ widget ⌨️ zle ⌨️ keybinding 🌿 branch πŸ”€ git
πŸ“‹ bufcopySecurity-Conscious Command Buffer Clipboard Copy122⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“‹ clipboard πŸ“‹ copy
✏️ bufeditEdit Command Buffer in External Editor115⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“ buffer ✏️ editor
πŸ“œ cliphSearchable Clipboard History (FZF + cliphist)121⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“‹ clipboard πŸ“œ history
πŸ“Ž cplastSmart-Tail Command Output Capture & Clipboard Export161⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“‹ clipboard πŸ“¦ cargo
🎯 ctxpickMulti-Source Context Picker131⌨️ widget ⌨️ zle ⌨️ keybinding πŸ” fzf 🎯 context
πŸ“‚ fdpickFile/Directory Picker (fd + FZF, Context-Aware)120⌨️ widget ⌨️ zle ⌨️ keybinding πŸ” fzf πŸ” fd
πŸ” fpickFunction Picker (FZF, Doc + Source Preview)97⌨️ widget ⌨️ zle ⌨️ keybinding πŸ” fzf πŸ“‚ file
πŸ”€ jtogBidirectional JSON Prettifier/Minifier Toggle111⌨️ widget ⌨️ zle ⌨️ keybinding 🧹 json 🧹 jq
πŸ“– manfMan Page Picker (FZF, Live Preview)118⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“– man πŸ” fzf
πŸ“Œ pastemSmart Clipboard Paste Widget (Sanitized, Joined)Pastes clipboard into the command line with sanitization: strips markdown128⌨️ widget ⌨️ zle πŸ“‹ clipboard ⌨️ keybinding πŸ“Œ paste
πŸ“„ pasterawRaw Clipboard Paste (No Sanitization)88⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“‹ clipboard πŸ“Œ paste
πŸš€ pjumpProject Jump (Zoxide + FZF, Git & Activity Preview)ZLE widget: jump to directories via zoxide frecency list + FZF; preview shows128⌨️ widget ⌨️ zle ⌨️ keybinding πŸ” fzf πŸ“ zoxide
πŸ“Š qlogQuick Command Logger to Project Scratch File137⌨️ widget ⌨️ zle ⌨️ keybinding πŸ“ logging πŸ†• scratch
πŸ”“ sudotSudo Prefix Toggle with Credential Prediction124⌨️ widget ⌨️ zle ⌨️ keybinding πŸ”“ sudo πŸ”‘ password
πŸ’‘ whelpWidget Help Palette & Keybinding Reference148⌨️ widget ⌨️ zle ⌨️ keybinding ❓ help πŸ” fzf

πŸ”’ Private FunctionsΒΆ

πŸ”’ Private Functions (2) 2/2
NameTitlePurposeLOCDEPSTags
πŸ—ΊοΈ _get_project_contextHeuristic Project Profile Generator for AI ContextPrivate utility: analyzes current directory to generate a technical profile.136πŸ”’ private πŸ”’ internal 🎯 context πŸ”€ git πŸ—ΊοΈ project
πŸ“‘ _zshand_network_monitorBackground Network State Tracker for Atuin Sync163πŸ”’ private πŸ”’ internal 🌐 network 🐚 atuin πŸ“‘ monitor

πŸ’» CLI Tools (bin/)ΒΆ

πŸ’» CLI Tools (bin/) (45) 45/45
NameTitlePurposeLOCDEPSTags
πŸ“„ agent-accounts1545
πŸ“„ agents-docs291
πŸ€– aicontextAI Context Generator for Code AssistantsGenerates comprehensive project context for AI coding assistants (Cursor,2211πŸ’» cli πŸ’» bin πŸ€– ai 🎯 context
πŸ“Έ archshotsAutomatic Screenshot ArchiverMonitors screenshot directory and automatically archives when threshold1841πŸ’» cli πŸ’» bin πŸ“Έ screenshot πŸ“‘ monitor 🧭 navigation πŸ—ƒοΈ archive
πŸ”Ž auditenvEnvironment Variable Integrity AuditorValidates that critical environment variables are defined and populated.2081πŸ’» cli πŸ’» bin βš™οΈ env πŸ›‘οΈ audit
πŸ“„ chrome-bookmarks-organizer.pyAI-Powered Chrome Bookmark Organizer765
πŸ“„ claude-code-docs5871
πŸ”„ cloudsyncCloud Sync Engine for .cloud-pin FilesCentral CLI for the cloud-pin sync system. Scans for .cloud-pin files,20743πŸ’» cli πŸ’» bin cloud πŸ”„ sync rclone pueue
πŸ“„ codex-docs5831
✏️ cspellfixInteractive cSpell Dictionary Manager with TOML Support29592πŸ’» cli πŸ’» bin πŸ“š docs
πŸ“„ cursor-appimage-install140
πŸ”ƒ diffenvEnvironment Manifest Validator1551πŸ’» cli πŸ’» bin βš™οΈ env πŸ”ƒ diff
πŸ“„ direnv-allowScan and allow direnv .envrc files237
πŸ“š docgenLiving Documentation Generator2101πŸ’» cli πŸ’» bin πŸ“š docs
πŸ—œοΈ envconsolidateEnvironment Variable Consolidation ToolRecursively searches for environment variable definitions across multiple344πŸ’» cli πŸ’» bin βš™οΈ env
πŸ•΅οΈ find-undocumented-varsFind ZSHAND_* variables missing from samples505πŸ’» cli πŸ’» bin πŸ“š docs πŸ›‘οΈ audit
πŸ›‘οΈ header_priority_auditFind Worst Headers & Output LLM Improvement DirectionsRanks all .zsh files by body/header ratio and emits an LLM-oriented10925πŸ’» bin headers πŸ›‘οΈ audit
🧩 import-ohmyzsh-pluginsImport oh-my-zsh Plugins to ZSHAND1677πŸ’» cli πŸ’» bin πŸ“₯ import 🧩 plugin 🧩 omz
🎨 import-p10k-themePowerlevel10k Theme Configuration Importer464πŸ’» cli πŸ’» bin πŸ“₯ import βš™οΈ config 🎨 theme 🎨 p10k
🎭 import-prezto-themesPrezto Theme Importer for ZSHAND5981πŸ’» cli πŸ’» bin πŸ“₯ import 🎨 theme 🧩 prezto
πŸ“„ omniconvert467
πŸ“‹ pcopyHigh-Performance Local File Transfer ToolIntelligent file transfer with automatic mode selection (rsync delta vs5352πŸ’» cli πŸ’» bin πŸ“‹ clipboard πŸ”„ sync πŸ“Š perf
πŸ”„ persyncPersistent Resilient Remote Sync ToolFault-tolerant remote sync with automatic retry on connection loss.5761πŸ’» cli πŸ’» bin πŸ”„ sync
πŸ“„ pilot-shell-docs6141
πŸ”— rclinkOS-Aware ~/.zshrc Synchronizer2251πŸ’» cli πŸ’» bin πŸ”„ sync πŸ”— link
πŸ—οΈ scaffoldProject Scaffolding from AI Context1661πŸ’» cli πŸ’» bin πŸ—οΈ scaffold πŸ€– ai 🎯 context
πŸ“· sshotCross-Environment Screenshot Capture4081πŸ’» cli πŸ’» bin πŸ“Έ screenshot βš™οΈ env
πŸ“„ sync-dashboardLive Cloud Sync TUI Dashboard652
πŸ’Š syssnapSystem State Snapshot Generator2011πŸ’» cli πŸ’» bin πŸ“Έ snapshot πŸ’Š system
πŸ§ͺ testinitShell Initialization Test Harness125πŸ’» cli πŸ’» bin πŸ§ͺ testing
πŸ“Ί txmonActive Transfer Monitor Dashboard1611πŸ’» cli πŸ’» bin πŸ“‘ monitor
πŸ“„ vsxVSCode/Cursor/Windsurf/Antigravity Extension ManagerUnified CLI + TUI + importable module to manage extensions across VSCode,96851
πŸ“„ vsx.pyVSCode/Cursor/Windsurf/Antigravity Extension ManagerUnified CLI + TUI + importable module to manage extensions across VSCode,96851
πŸ“‚ zdDiff-Based Configuration EditorSafe config editing with diff preview and confirmation before applying2281πŸ’» cli πŸ’» bin βš™οΈ config πŸ”ƒ diff ✏️ editor
✏️ zeFast Configuration Editor with Auto-RebuildQuick config editing with syntax validation and automatic rebuild. Skips2171πŸ’» cli πŸ’» bin πŸ”¨ build βš™οΈ config πŸ”„ rebuild ✏️ editor
🌱 zfreshFresh Full Bundle Recompilation with Shell Restart177πŸ’» cli πŸ’» bin πŸ“¦ bundle πŸ”„ rebuild
πŸ”¨ zfullFull Bundle Builder (Framework + User Config)1862πŸ’» cli πŸ’» bin πŸ“¦ bundle πŸ”¨ build βš™οΈ config πŸ—οΈ framework
πŸ“¦ zmonoMonolithic Framework Bundle Compiler1493πŸ’» cli πŸ’» bin πŸ”„ compile πŸ“¦ bundle πŸ—οΈ framework
⏱️ zprofileProfile Bundle Generator and Runner4711πŸ’» cli πŸ’» bin πŸ“¦ bundle πŸ“ˆ profile
πŸƒ zrZsh Framework Rebuilder (zprime launcher)Convenient launcher for zprime when it isn't loaded. Loads the ZSHAND1542πŸ’» cli πŸ’» bin πŸ”¨ build πŸ”„ rebuild πŸ—οΈ framework
πŸ”— zr-deps1531πŸ’» cli πŸ’» bin
πŸ“ zr-dirSingle Directory Framework Rebuilder1552πŸ’» cli πŸ’» bin πŸ”¨ build πŸ”„ rebuild πŸ—οΈ framework 🧭 navigation
πŸ”¨ zrebuildForce Complete Rebuild with Validation1922πŸ’» cli πŸ’» bin πŸ”¨ build πŸ”„ rebuild
⚑ zrecompileSelective Recompilation for ZSHAND Framework2134πŸ’» cli πŸ’» bin πŸ”„ compile πŸ—οΈ framework
⬆️ zupdateComplete System Maintenance Orchestrator1781πŸ’» cli πŸ’» bin ⬆️ update πŸ€– ai πŸ’Š system