update readme getting started
support for expandable paths; add debug options