🧠 Improve CLI help output and documentation

[szmyty]

Title: 🧠 Improve CLI help output and documentation

---

Description

Refine CLI help output to clearly describe usage and commands.

---

Goals

• Improve discoverability
• Make CLI self-documenting

---

Requirements

• Add descriptions to:
  • CLI root
  • commands
  • arguments
• Ensure "--help" output is clean and helpful

---

Acceptance Criteria

• Help output is clear and readable
• Commands and flags documented
• UX feels intuitive