update readme with better comments for console tools