Skip to content
CLI helper for local development
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.


Sage is helper for development environment on macOS (High Sierra, Mojave).


  1. Since Sage depends on Brew. Install or update Homebrew to the latest version using brew update.
# if not installed
/usr/bin/ruby -e "$(curl -fsSL"

# add the next line into your ~/.bash_profile file (create if not exists)

export PATH="$PATH:/usr/local/sbin:$HOME/bin:$HOME/.composer/vendor/bin"

# if installed

brew update
brew upgrade
  1. Download phar package from the latest release and put it in $HOME/bin folder.
curl -L > $HOME/bin/sage
chmod +x $HOME/bin/sage
  1. [Optional step] Customize configuration
# It creates configuration dump ~/xSage/config.php.
# You can customize and move it to ~/.sage/config.php before next step if you want.

sage env:config-dump
  1. Install and configure required environments
# It's automatic, you will prompt to enter your password once and two times MySQL root password.
# If you don't have installed MySQL before, just press enter (there is no password by default).
# After installation MySQL root password is 1 (until you changed it in ~/.sage/config.php config in node mysql.password)

sage env:install
  1. [Optional step] Install Bash completion for the application
sage env:completion
  1. Ready to use
# Displays a list of supported commands with short descriptions

sage list
You can’t perform that action at this time.