[CLI] Accept spaces/user/repo as repo ID prefix shorthand

[Wauplin]

Summary

Accept repo IDs like spaces/user/repo, datasets/user/repo, models/user/repo as shorthand for user/repo --type space etc. This is implemented at the HFCliTyperGroup.resolve_command() level, so it works automatically for all commands that accept --type/--repo-type — no per-command changes needed.

Follows the same pattern as the --json → --format json rewrite from #3919.

# before
hf download user/my-space --type space
hf discussions list user/my-dataset --type dataset

# after
hf download spaces/user/my-space
hf discussions list datasets/user/my-dataset

• Error if both a prefix and explicit --type flag are provided (ambiguous)
• Error if multiple prefixed args disagree on the type
• Commands without --type option are unaffected

Addresses #3906 (comment)

Test plan

• spaces/user/repo rewrites to user/repo --type space on download
• datasets/user/repo rewrites to user/repo --type dataset on download
• models/user/repo rewrites to user/repo --type model on download
• Error when prefix + explicit --type both provided
• Error when prefix + explicit --repo-type both provided
• Normal repo IDs (no prefix) unchanged
• Works on nested subcommands (repos settings)
• Not applied on commands without --type
• Existing --json shorthand tests still pass

🤖 Generated with Claude Code

---

Note

Medium Risk
Changes global CLI argument rewriting for any command exposing --type/--repo-type, which could subtly affect parsing of positional arguments and error behavior. Guardrails and tests reduce risk, but regressions could impact multiple commands.

Overview
Adds a CLI shorthand so repo IDs can be passed as spaces/<org>/<repo>, datasets/<org>/<repo>, or models/<org>/<repo>, automatically rewriting them to <org>/<repo> plus an implicit --type value during command resolution.

The rewrite only applies to commands that accept --type/--repo-type, errors on mixed/ambiguous usage (prefix + explicit type, or conflicting prefixes across args), and extends tests to cover download and nested subcommands while keeping --json pass-through behavior intact.

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

[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.}

[cursor]

Prefix rewriting incorrectly matches non-repo-ID arguments

Medium Severity

_rewrite_repo_type_prefix treats every non-flag argument (except index 0) as a potential prefixed repo ID, but commands like download, upload, and delete-files accept additional positional args (filenames, local paths, patterns) and option values after flags like --revision or --local-dir. A path like models/weights/model.safetensors passed as a filename to hf download, or datasets/train/data.csv passed as local_path to hf upload, would be incorrectly matched, stripped of its prefix, and cause --type to be appended — silently corrupting the argument.

 

[hanouticelina]

agree with cursor here, we should scan only repo id positional args.

[hanouticelina]

Codex suggested to use cmd.params to know which tokens are click.Arguments, and only inspect arguments whose name is repo_id

[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.

[hanouticelina]

thank you!

[hanouticelina]

agree with cursor here, we should scan only repo id positional args.

[hanouticelina]

we can use constants.REPO_TYPES_MAPPING here

[hanouticelina]

Codex suggested to use cmd.params to know which tokens are click.Arguments, and only inspect arguments whose name is repo_id