Exec remote API documentation

Includes
1. minor code cleanup 
2. addition of a TODO
3. updated CLI documentation.

Ping @cpuguy83 
Tried to fix it :)