Hyperiux Vault

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 '<name>' 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.

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.