Fix `--help` for AI agents & humans

[patrikbraborec]

Summary

The --help output across all CLI commands needs improvements to be useful for both AI agents and human users.

Action Items

• Add usage examples to all commands
• Add links to docs in help output
• Fix: actor --help never mentions it is an alias for apify actor
• Fix: misleading command descriptions (e.g., runs says "Manages Actor run operations" but runs create doesn't exist)
• Help should distinguish local Actor development commands from remote platform commands
• Add new commands like search
• Mark interactive commands explicitly (so agents know to avoid them / how to use them)
• Be defensive: help as argument should work like --help
• apify init --yes does not work in non-interactive mode (mark interactive commands, provide non-interactive alternatives)

Reference

• gh and mcpc CLIs for inspiration on help output quality

Supersedes

• feat: Add actors search command to search Apify Store from CLI #1045 (feat: Add actors search command to search Apify Store from CLI)