: Neon-Lit UNIX Terminal Operating System for the Digital Underground

Main Version Commits Contributors

 _______ _______ _  _  _ ______
|____   |_____  | |  \| |_____/
    /  / |_____] |_|\_| |    \_  v48.7.3
>>> JACK INTO THE GRID <<<

"The street finds its own uses for things." -- William Gibson

This project began as a fork of Hashrocket's Dotmatrix and evolved into something far beyond its origins -- a sprawling cyberdeck OS for the command line.

ZPWR is a high-voltage terminal environment built on zinit, weaponized with layers of custom zsh, bash, vimL and perl code. It rewires your shell into a neural interface -- autocomplete that anticipates your next move, keybindings that feel like muscle memory from a past life, and a tmux cockpit that turns your terminal into a multi-pane command center.

If your terminal isn't glowing, you're not running ZPWR.

System Map

• Full Install -- Jack In
• Install Options -- Configuration Flags
• Augmentations -- System Specs
• Firmware Stack -- Required Components
• Compatible Chassis -- Supported Platforms
• Black Market Extras -- Optional Gear
• Minimal Implant -- Lightweight Install
• Unplug -- Clean Removal
• Glyph Firmware -- Font Setup
• Patching In -- Updates
• Tmux Prefix -- The Activation Key
• Vim Autosave -- Persistent Memory
• Auto Display Completion Choices -- Predictive Input
• Bypass Space Expansion -- Override Expansion
• Turning Off Ponies And Colors -- Kill The Neon
• Vim Language Support -- Supported Runtimes
• Main Window -- The Cockpit
• Personal Config -- Your Identity File
• ZPWR Verbs -- Command Vocabulary
• ZPWR auto menu completion -- Predictive Completion
• Github Account Variable -- Network Identity
• Adding Zsh Plugins -- Sideloading Modules
• Environment Variables -- System Tuning
• Test Suite -- Diagnostics
• Shell Startup Speed -- Boot Time
• Startup Benchmark -- zpwr bench
• Environment Snapshots -- zpwr snapshot / zpwr restore
• Live Dashboard -- zpwr top
• Health Check -- zpwr doctor
• Flame Chart -- zpwr flame
• Startup Profile -- zpwr startup
• Shell Lint -- zpwr lint
• Listening Ports -- zpwr ports
• Stale File Finder -- zpwr stale
• Path Audit -- zpwr pathaudit
• Git Who -- zpwr gitwho
• History Timeline -- zpwr timeline
• Alias Analytics -- zpwr aliasrank
• Function Rank -- zpwr funcrank
• File Watcher -- zpwr watch
• Command Replay -- zpwr replay
• Command Trace -- zpwr trace
• Function Dependencies -- zpwr deps
• Colorized Log Viewer -- zpwr taillog
• Resolve -- zpwr resolve
• Fortune -- zpwr fortune
• Matrix -- zpwr matrix
• The ZPWR Encyclopedia -- zpwr wizard
• Contributing -- Join The Grid
• Warning -- Read Before Modifying
• MacbookPro Screenshots
• Raspberry Pi Screenshots
• Rock64 Screenshots
• KeyBindings -- Neural Mappings
• Tmux Keybindings
• Zsh Vim Insert Mode
• Zsh Vim Normal Mode
• Zsh Vim MenuSelect Mode
• Zsh Vim Visual Mode
• Zsh Vim ListScroll Mode
• Zsh Vim Operator Mode
• Vim Insert Mode
• Vim Normal Mode
• Vim Visual Mode
• Vim Command Colon Mode

Full Installation -- Jack Into ~/.zpwr

sh -c "$(curl -fsSL raw.githubusercontent.com/MenkeTechnologies/zpwr/main/install/s)"

OR

git clone --depth 1 -- https://github.com/MenkeTechnologies/zpwr.git ~/.zpwr && cd ~/.zpwr/install && ./zpwrInstall.sh

The installer will confirm what will be installed and overwritten before executing.

Zinit will install plugins on first zsh after install.

Full Installation to Custom $ZPWR -- Choose Your Safehouse

To install to a custom directory, clone the project to custom directory and start the installer. ZPWR will pick up its location and export ZPWR to that directory. This also means you can move ZPWR after install after updating the sym links that are in $HOME. First export ZPWR_INSTALL=<mydirectory>/install in current shell. Replace <mydirectory> with your new install dir and keep /install in the export. Then run zpwr regenconfiglinks in same shell to create new sym links pointing to your new directory <mydirectory>. Then exec a new zsh with exec zsh and all environment variables will be set accordingly.

Installation Options to ~/.zpwr/install/zpwrInstall.sh

    Options:
        -a  Install all dependencies
        -c  Copy just configs
        -n  Do not start tmux at end of installer
        -s  Skip main section
        -h  Display this message
        -V  Display script version

ZPWR Augmentations

[ SYSTEM SPECS // ACTIVE MODULES ]

• 506+ zpwr subcommands -- your neural command vocabulary with colorized zsh menucompletion zpwr <tab>
• 215+ centralized environment variables in the ZPWR namespace -- dials and switches for every subsystem
• 890+ centralized ZPWR files in ~/.zpwr -- clean uninstall, no ghost processes
• 17k zsh tab completions including zsh-more-completions -- predictive input at machine speed
• 170+ bash, perl, zsh and python scripts in ~/.zpwr/scripts or $ZPWR_SCRIPTS git tracked
• 2000+ aliases -- shorthand for the initiated
• 360+ git aliases from OMZ git plugin and zsh-git-acp
• user specific ZPWR files in ~/.zpwr/local git ignored -- your private data vault
• installer specific ZPWR files in ~/.zpwr/install git tracked
• ZPWR installer output in ~/.zpwr/local/installer git ignored
• central kill switch for zpwr colorful output with ZPWR_COLORS
• zsh completion with descriptions for parameters, regular, suffix and global aliases
• spelling correction, abbreviation expansion and automatic capitalization on the command line zsh-expand -- the shell corrects you before you finish typing
• snippets with tabstops that expand with spacebar and advance to next stop with C-o zsh-expand
• expanding regular aliases and global aliases from zsh menu selection and in vim insert mode zsh-expand
• optional preexec expansion of regular aliases and global aliases or only history expansion of aliases
• neon-coded groups of zsh menu completion for commands, aliases, reswords, functions, builtins, parameters, files, command history, correction
• neon-coded groups of zsh menu completion for man pages
• neon-coded groups of zsh menu completion for git subcommands
• neon-coded groups of zsh menu completion for git objects
• heavily colorized man pages zsh-very-colorful-manuals -- manpages that glow
• insert matching quotes, brackets and parentheses like most IDEs zsh-autopair
• custom keybinding to open file