[CLI] Complete hf papers with search, info, read + ls filters

[mishig25]

Summary

Builds on #3723 to add the remaining hf papers commands, covering all functionality described in huggingface/skills#87.

New commands:

• hf papers search <query> — search papers via /api/papers/search
• hf papers info <paper_id> — structured JSON metadata via /api/papers/{id}
• hf papers read <paper_id> — full paper content as markdown via /papers/{id}.md

Extended hf papers ls:

• --week — filter by ISO week (e.g. 2025-W09)
• --month — filter by month (e.g. 2025-02)
• --submitter — filter by submitter username

New HfApi method:

• paper_read(id) — fetches {endpoint}/papers/{id}.md and returns markdown as a string

Test plan

• 14 unit tests added to TestPapersCommand in tests/test_cli.py
• All 14 tests pass
• ruff check and ruff format clean

🤖 Generated with Claude Code

---

Note

Medium Risk
Adds new CLI subcommands and a new HfApi.read_paper HTTP call; moderate risk due to new network paths and error handling, but changes are scoped to the papers feature set.

Overview
Extends hf papers beyond daily listing by adding search, info (JSON metadata), and read (markdown content) commands, with consistent table/json/quiet output behavior.

Enhances hf papers ls with additional server-side filters (--week, --month, --submitter) and wires these through to HfApi.list_daily_papers; introduces HfApi.read_paper and exports it at the package level.

Updates CLI docs/reference and adds a dedicated TestPapersCommand suite covering the new commands, options, and 404-to-CLIError handling.

^{Written by Cursor Bugbot for commit 9819f6c. This will update automatically on new commits. Configure here.}

[cursor]

Highlight PR — Description Clarity Suggestion

This PR is a meaningful feature addition that deserves a clear user-facing summary at the top of the description. The current description jumps into implementation-oriented bullet points without first explaining the user-visible impact in prose. Consider replacing the Summary section with something like:

---

Summary

The hf papers CLI now supports the full spectrum of paper interactions on the Hugging Face Hub. You can search for papers by keyword, retrieve structured JSON metadata for any paper, and read an entire paper as markdown directly in your terminal. The hf papers ls command also gains new server-side filters for week, month, and submitter, making it easier to navigate the daily papers feed. On the Python side, a new HfApi.paper_read() method lets you programmatically fetch any paper's content as markdown.

# Search papers by keyword
hf papers search "vision language"

# Get structured metadata about a paper
hf papers info 2502.08025

# Read a paper as markdown in your terminal
hf papers read 2502.08025

# List papers filtered by week or submitter
hf papers ls --week 2025-W09
hf papers ls --submitter someuser

from huggingface_hub import HfApi
api = HfApi()
content = api.paper_read("2502.08025")

New commands:

• hf papers search <query> — search papers via /api/papers/search
• hf papers info <paper_id> — structured JSON metadata via /api/papers/{id}
• hf papers read <paper_id> — full paper content as markdown via /papers/{id}.md

Extended hf papers ls filters:

• --week — filter by ISO week (e.g. 2025-W09)
• --month — filter by month (e.g. 2025-02)
• --submitter — filter by submitter username

---

The bullet lists are fine (4+ sub-features), but leading with a prose summary makes the user-visible impact immediately clear.

  

_{Sent by Cursor Automation: PR Description}

[bot-ci-comment]

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[hanouticelina]

Very nice! completing the hf papers CLI will allow us to stop maintaining a separate skill for this (this one I think) and use the hf CLI skill instead, which is always up-to-date

[hanouticelina]

personal preference for hf papers view here instead of read. view gives us room if we ever want to add the possibility to open the paper in a browser with something like hf papers view 2601.15621 --web. also view might be more discoverable than read?

any preference @julien-c @Wauplin @gary149 ?

[julien-c]

i kinda like read better here, but no strong opinion at all!

[julien-c]

for me view would actually be more like info