Browse or search the Hyperiux Vault catalog of React/Next.js interaction effects (scroll systems, cursor trails, WebGL scenes, animated buttons, page transitions, etc).

Does NOT return which effects are Pro vs Free - the catalog index this reads from doesn't carry that field today. Use hyperiux_get_effect on a specific slug to check its tier before assuming it's installable without a Hyperiux Pro account.

Args:

• query (string, optional): substring match against effect name

• category (string, optional): filter to one category slug

• limit (number, default 30, max 100)

• offset (number, default 0)

Returns JSON: { total, count, offset, effects: [{ name, category, categories, dependencies, version }], has_more, next_offset? }

Examples:

• "What cursor effects are available?" -> category="cursor"

• "Is there anything with 'particles' in the name?" -> query="particles"

• Don't use when: you need one effect's full description/props/tier - use hyperiux_get_effect instead.

Get full details for one Hyperiux Vault effect by its exact slug - description, tier (free/pro), npm dependencies, version, changelog, and install instructions. Optionally includes full source code.

Args:

• name (string): exact effect slug

• include_source (boolean, default false): also return component source. Free effects: always available. Pro effects: only if authenticated (see below).

Returns JSON: { name, title, description, tier, version, dependencies, changelog, install_command, preview_url, import_path, target, main, import_statement, files: [{ path, content? }] }

• changelog: array of { version, date, summary, breaking }, newest first

• files[].content is omitted unless include_source=true AND the effect is accessible (free, or Pro with a valid token)

• import_statement is the exact import line to use after installing (e.g. import { DottedGrid } from "@/components/effects/dotted-grid";), built from exportKind/exportName/import_path the same way the CLI's own hyperiux add output does - omitted if the registry entry has no import_path

• install_limit/install_remaining: present on a normal (non-rate-limited) lookup, telling you how many more distinct effects this identity can fetch today - mention this to the user when remaining is low, same as the website's copy toast and the CLI's own "N of M daily installs left" line

Pro effects without a token: the response still includes metadata (description, dependencies, changelog) but files have no content, and a note explains the effect requires a Hyperiux Pro account - don't treat this as an error, it's expected for unauthenticated Pro lookups.

Free effects past the caller's daily install cap: the response still includes metadata but files have no content, and rate_limited/rate_limit_reason explain the daily limit and when to retry - also not an error, it's expected once the cap is hit.

Examples:

• "What does the dotted-grid effect need?" -> name="dotted-grid" (dependencies field)

• "Show me the code for circle-text-reveal" -> name="circle-text-reveal", include_source=true

• Don't use when: you don't have an exact slug yet - use hyperiux_list_effects first.

Error Handling:

• Returns "Effect '' not found" if the slug doesn't exist - check hyperiux_list_effects for the correct spelling.

List every effect category in the Hyperiux Vault catalog with how many effects are in each - useful before calling hyperiux_list_effects with a category filter, to confirm the exact category slug and see relative size.

Returns JSON: { categories: [{ category, count }] }, sorted by count descending.

Examples:

• "What kinds of effects does Hyperiux have?" -> call with no args

• Don't use when: you already know the category slug and just want its effects - call hyperiux_list_effects directly.