update readme and add shell functions