# Hf CLI

> Hf CLI is an open-source agent skill for ai models and llm tooling. Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/huggingface/skills/tree/main/skills/hf-cli
- **Repository:** https://github.com/huggingface/skills
- **GitHub stars:** 11,356
- **License:** Apache-2.0
- **Skill name:** hf-cli
- **Collection:** https://github.com/huggingface/skills
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-17

## About

Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. Use when: handling authentication; managing local cache; managing Hugging Face Buckets; running or scheduling jobs on Hugging Face infrastructure; managing Hugging Face repos; discussions and pull requests; browsing models, datasets and spaces; reading, searching, or browsing academic papers; managing collections; querying datasets; configuring spaces; setting up webhooks; or deploying and managing HF Inference Endpoints. Make sure to use this skill whenever the user mentions 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or 'hugging face cli', or wants to do anything related to the Hugging Face ecosystem and to AI and ML in general. Also use for cloud storage needs like training checkpoints, data pipelines, or agent traces. Use even if the user doesn't explicitly ask for a CLI command. Replaces the deprecated `huggingface-cli`.

## When your agent uses it

> Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. Use when: handling authentication; managing local cache; managing Hugging Face Buckets; running or scheduling jobs on Hugging Face infrastructure; managing Hugging Face repos; discussions and pull requests; browsing models, datasets and spaces; reading, searching, or browsing academic papers; managing collections; querying datasets; configuring spaces; setting up webhooks; or deploying and managing HF Inference Endpoints. Make sure to use this skill whenever the user mentions 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or 'hugging face cli', or wants to do anything related to the Hugging Face ecosystem and to AI and ML in general. Also use for cloud storage needs like training checkpoints, data pipelines, or agent traces. Use even if the user doesn't explicitly ask for a CLI command. Replaces the deprecated `huggingface-cli`.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/huggingface/skills/tree/HEAD/skills/hf-cli)
- [License: Apache-2.0](https://github.com/huggingface/skills/tree/HEAD/skills/hf-cli)

## Install

### Claude Code

This skill ships in the `hf-cli` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills
```

Or copy only this skill to `~/.claude/skills/hf-cli`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.claude/skills/hf-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/hf-cli` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/hf-cli` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.agents/skills/hf-cli &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/hf-cli` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/hf-cli` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.cursor/skills/hf-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/hf-cli` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/huggingface/skills.git --path skills/hf-cli
```

Or copy the folder to `~/.gemini/skills/hf-cli` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/hf-cli`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.copilot/skills/hf-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/hf-cli` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/huggingface/skills.git
```

Then copy `skills/skills/hf-cli` into your agent's skills folder as `hf-cli`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Hf CLI in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/hf-cli to use it in all your projects, or to .claude/skills/hf-cli in one project. Or install the hf-cli plugin, which includes it: /plugin marketplace add huggingface/skills, then /plugin install hf-cli@huggingface-skills.

### Does Hf CLI run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Hf CLI?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Hf CLI?

The closest alternatives to Hf CLI are Academy guide, Claude API, MCP builder, Nano banana pro openrouter and Generate image.

## Alternatives

- [Academy guide](https://ai-powered.com/skills/academy-guide): Academy guide is an agent skill for ai models and llm tooling.
- [Claude API](https://ai-powered.com/skills/claude-api): Claude API is an agent skill for ai models and llm tooling.
- [MCP builder](https://ai-powered.com/skills/mcp-builder): MCP builder is an agent skill for ai models and llm tooling.
- [Nano banana pro openrouter](https://ai-powered.com/skills/nano-banana-pro-openrouter): Nano banana pro openrouter is an open-source agent skill for design and media.
- [Generate image](https://ai-powered.com/skills/generate-image): Generate image is an open-source agent skill for design and media.
- [Phoenix evals](https://ai-powered.com/skills/phoenix-evals): Phoenix evals is an open-source agent skill for ai models and llm tooling.
- [Prompt optimizer](https://ai-powered.com/skills/prompt-optimizer-github): Prompt optimizer is an open-source agent skill for ai models and llm tooling.
- [Tldr prompt](https://ai-powered.com/skills/tldr-prompt): Tldr prompt is an open-source agent skill for ai models and llm tooling.

---
Source: https://ai-powered.com/skills/hf-cli
