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.