Exec remote API documentation

Includes
1. minor code cleanup 
2. addition of a TODO
3. updated CLI documentation.

Ping @cpuguy83 
Docs got duplicated after a recent merge. Fixed.