[codex] Simplify user flow and docs

[justAbdulaziz10]

What changed

• Added simpler commands: report, audit, redact, demo, wizard, and agent-prompt.
• Added timestamped report folders, --open, --shareable, better missing-path help, and clearer terminal summaries.
• Made demo generation self-contained in the CLI so installed users can run it.
• Simplified README, Quickstart, Export Guide, How It Works, and PyPI docs.
• Added a script and GitHub workflow to regenerate docs/assets/demo-report.png after pushes to main.

Validation

• make check
• make demo
• make path-smoke
• bash scripts/generate_demo_screenshot.sh
• make package PYTHON=python3

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 99d3ddd8fc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Restore legacy invocation when options precede input path

The new legacy shim only prepends report when the first token is not an option, so previously valid calls like inbox-report --no-pdf /path/to/Mail.mbox now fail with an invalid command error instead of running a strict report. This is a behavior regression introduced by the subcommand migration and will break existing scripts/automation that place flags before the positional input (which argparse accepted in the prior CLI).

Useful? React with 👍 / 👎.