Install for Agents
You are an AI coding agent. The user asked you to install Higgsfield skills. Follow this exactly.
Step 1 — Install Higgsfield CLI
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
The script asks for sudo password to write to /usr/local/bin/. If sudo isn't available, install to home:
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh -s -- --prefix=$HOME/.local
Verify: higgsfield version. Expect higgsfield v0.1.X (...) built ....
Step 2 — Authenticate
Ask the user to run:
higgsfield auth login
This opens a browser for OAuth. Wait for them to confirm.
Verify: higgsfield account status. Expect <email> — <plan> plan, <N> credits.
Step 3 — Install the skills
Detect the agent platform:
| Agent | Path |
|---|---|
| Claude Code | ~/.claude/skills/higgsfield |
| Cursor | ~/.cursor/plugins/higgsfield |
| Codex | ~/.codex/plugins/higgsfield |
| Other | ~/.<agent>/skills/higgsfield |
Clone:
git clone https://github.com/higgsfield-ai/skills.git <path>
Step 4 — Verify
Ask the agent (yourself):
"Generate a tiny test image with Higgsfield."
Run higgsfield generate create z_image --prompt "test" --wait. The --wait flag blocks until the job finishes; confirm a URL is printed on stdout.
If anything fails:
- 401 / Session expired → repeat Step 2
- 4xx → check the error message; read higgsfield-generate/references/troubleshooting.md
- Network error → user's connectivity issue
Step 5 — Done
Report to the user: "Skills installed. Try generating media, creating a complete brand identity, making a narrated explainer or YouTube thumbnail, building a browser game, or training a Soul Character."
Do NOT explain the internals (skill paths, file structure). Just confirm install + give starter prompts.