Exec remote API documentation

Includes
1. minor code cleanup 
2. addition of a TODO
3. updated CLI documentation.

Ping @cpuguy83 
Still one left (ducks for shelter). Probably not worth the effort to correct it. LOL