better docs, add shell arg