Skip to content
lightweight shell extensions
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


ozh lightweight shell extensions

  • ozh reboot - core module
  • 2008-2016 - anx @ ulzq de (Sebastian Glaser)
  • Licensed under GNU GPL v3

ozh is a package manager for various un+x-style shells. It's aim is to sanitize the environment and provide tools to install and depend upon modules.

Modules always live in a folder and follow a simple $mod/$mod convention as the entry-point.


cd; mkdir -p .config/ozh/core; cd .config/ozh/core;
curl "" > core;
. ./core libs;
oz printenv;
oz install @hakt0r/core

If this works you should be able to install new modules like this:

oz install @hakt0r/shell
oz install +prefix @hakt0r shell sys net
oz install https://secure-url/to/your/mod/main
oz install /absolute/path/to/your/mod/main

You can now safely add ozh to your shell profile:

echo "OZH_BOOT=true . ~/.config/ozh/core/core libs" >> $HOME/.bashrc
echo "OZH_BOOT=true . ~/.config/ozh/core/core libs" >> $HOME/.zshrc

Basic Usage

Install a module

oz install [FLAGS] $mod [...]

You can install multiple modules at a time, flags can be placed anywhere in the module list and take effect immediately. Modules can also be a URL in which case the corresponding entry will be set in $OZH/mod/repo.


  • +lib will add the following modules to the $OZH/libs file, unless they exist already.
  • -only will inhibit sourcing the following modules after install. Hooks will not be executed, hence install scripts will not run.
  • +prefix $prefix will add a prefix to the following modules as in: $prefix/$mod


oz install +lib shell                 # will be expanded to shell/shell
oz install +lib shell/abstracts       # update a module asset
oz install # install mod from the webs

View or edit ozh-stuff

oz get libs                           # get $OZH/libs
oz set libs 'core/core'               # set $OZH/libs to 'core/core'
oz edit libs                          # open $EDITOR for ...
oz edit shell/repo


oz hook run prompt
oz hook set prompt aa_date date
oz hook get prompt aa_date
oz hook edit prompt aa_date
oz hook del prompt aa_date


ozh is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

ozh is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this software; see the file COPYING. If not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

You can’t perform that action at this time.