Skip to content

Easy Menu - Super Simple Terminal Command Launcher Generator

Notifications You must be signed in to change notification settings


Repository files navigation

Easy Menu

Super Simple Terminal Command Launcher Generator

PyPI version Build Status Build Status Coverage Status License 'Stories in Ready'


Simplify your daily terminal operations!

Do you have any routine tasks such as login to your servers, deploying, troubleshooting or something like that?

This small tool would help to speed up your operations and prevent human errors. It should be helpful not only for salted engineers but unskilled operators.


  • Python: 2.6 / 2.7 / 3.2 / 3.3 / 3.4 / 3.5
  • pyyaml
  • six
  • jinja2 (version==2.6 if Python 3.2)
  • mog-commons


You can try Easy Menu by just two command lines.

pip install easy-menu

Note: will redirect to


  • pip command may need sudo
Operation Command
Install pip install easy-menu
Upgrade pip install --upgrade easy-menu
Uninstall pip uninstall easy-menu
Check installed version easy-menu --version
Help easy-menu -h
  • Then, write your configuration to the file easy-menu.yml.

See an example below.

Configuration Example


Main Menu:
  - Service health check: "echo Condition all green!"
  - Check hardware resources: "echo Hardware resources OK."
  - Server Login Menu:
    - Login to server-1: "echo logging into server-1"
    - Login to server-2: "echo logging into server-2"
    - Login to server-3: "echo logging into server-3"
  - Web Service Management Menu:
    - Check the status of web service: "echo Check web service status"
    - Start web service: "echo Start web service"
    - Stop web service: "echo Stop web service"
  - Reboot this server: "echo Reboot OS"

Each menu (i.e. root menu and sub menu) and each item is represented as Mapping which contains just one key-value pair. In case its value is a Sequence, the sub menu will be generated.

The general syntax is like this.

meta:                            # Some meta variables are available

  - SUB_MENU_TITLE:              # You can create sub menu if you need.
    - SUB_MENU_TITLE:            # More nested menu
  - ITEM_DESCRIPTION:            # You can write a list of command lines for one item.
      - COMMAND1
      - COMMAND2
      - COMMAND3
  - include: INCLUDE_FILE_PATH   # "include" keyword enables to load
                                 #   another configuration file.
  - eval: COMMAND                # "eval" keyword will execute command line
                                 #   and use its output as configuration YAML string.

Remember these commands are executed after changing the current directory to the directory which holds the configuration file by default.

You can find more examples in this directory.

Lookup Path

Similar to Vagrant, when you run any easy-menu command, Easy Menu climbs up the directory tree looking for the first easy-menu.yml it can find, starting first in the current directory. So if you run easy-menu in /home/mogproject/projects/foo, it will search the following paths in order for a easy-menu.yml, until it finds one:


This feature lets you run easy-menu from any directory in your project.

You can change default name of the configuration file by setting the EASY_MENU_CONFIG environmental variable to some other name.

Audit Logging

Anytime you execute the command, the result (return code) will be recorded to the syslog facility in your operating system. This feature is not available on Windows OS.


Aug 31 00:09:59 ullr.local easy-menu[28802]: [INFO] Command started: echo Condition all green!
Aug 31 00:09:59 ullr.local easy-menu[28802]: [INFO] Command ended with return code: 0

Go further

Need more help?