Exec remote API documentation

Includes
1. minor code cleanup 
2. addition of a TODO
3. updated CLI documentation.

Ping @cpuguy83 
can you do a grep for `active` please