README is missing several documented CLI options (--head/--tail, --emoji, --rst, --inspect, --max-width, --panel-style, --title/--caption, --export-svg, --version)

Open Beginner friendly
#136 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
python
Domain
cli, documentation

Research direction

Start in the README's existing CLI options documentation and compare it with the output of rich --help from the reported rich-cli version. Add short descriptions and examples for the listed missing flags, including any stated requirements, and confirm that every option in the issue is represented in the README.

Written by the indexing model from the issue text.

Description

Running rich --help shows a number of options that aren't documented anywhere in the README:

  • -h/--head and -t/--tail — display first/last N lines (requires --syntax or --csv)
  • -j/--emoji — enable emoji codes
  • --rst — render reStructuredText
  • --syntax — explicit syntax-highlighting flag
  • --inspect — inspect a Python object
  • -W/--max-width
  • -S/--panel-style (requires --panel)
  • --title / --caption
  • --export-svg
  • -v/--version

The README documents most other flags (--style, --panel, --rule, etc.) with a short description and example, but these are missing entirely. Would be happy to submit a PR adding a short section for these if that's welcome.

Repro: pip install rich-cli && rich --help (v1.8.1)

Dominant language
Python
Stars
3.7k
Forks
117
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Textualize/rich-cli

All issues in Textualize/rich-cli

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.