hub/pr_2437/en/agents-cli.md

Hugging Face CLI for AI Agents

The hf CLI is a great way to connect your agents to the Hugging Face ecosystem. Search models, manage datasets and buckets, launch Spaces, and run jobs from any coding agent.

This is a quick guide on agents that use the CLI. For more detailed information, see the CLI Reference itself.

Install the CLI

Make sure the hf CLI is installed and up to date. See the CLI installation guide for setup instructions.

Add the CLI Skill

Skills give your agent the context it needs to use tools effectively. Install the CLI Skill so your agent knows every hf command and stays current with the latest updates. Learn more about Skills at agentskills.io.

# install globally (available in all projects, works with Codex, Cursor, OpenCode,
# and any agent that loads skills from ~/.agents/skills)
hf skills add --global

# for Claude Code use the --claude flag
hf skills add --claude --global

# or install for the current project only (works with Codex, Cursor, OpenCode,
# and any agent that loads skills from .agents/skills)
hf skills add

# for Claude Code, use the --claude flag
hf skills add --claude

The Skill is generated from your locally installed CLI version, so it's always up to date.

Alternatively, you can install via the Claude Code plugin system:

claude
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface/skills

Resources

• CLI Reference - Complete command documentation
• Token Settings - Manage your tokens
• Jobs Documentation - Compute jobs guide