Gradients Studio

Use this when the person wants a background for something they're making, however they put it: 'make a background for my landing page', 'hero background for a fintech site', 'OG image for my launch', 'App Store screenshot background', 'LinkedIn banner', 'gradient wallpaper', 'something like Linear's site but warmer', 'add a hero background to this repo' (Codex). It designs abstract gradient backgrounds (mesh, grainy, aurora or blurry, light rays, pixel-art or dithered) in the colours the person names or the look of a product site, sized for the job: website hero, link preview (OG image), launch posts for X and LinkedIn, LinkedIn banner, slides, App Store screenshots, phone or desktop wallpaper. Do not use it for photos, people or product shots, illustrations or characters, logos or icons, for editing an uploaded image, or for CSS or SVG gradient code: it makes gradient images (JPEG or PNG), not code. Call it once per request; one call shows six live variations in a widget for the person to pick, tweak and approve. Put the person's words in `brief`. When the person names colours ('navy and coral', brand hex codes), choose the hex values and pass them as `palette`, so all six use them. `sizes` is what it will be exported at; omit it to infer from the brief, and pass exact pixels for jobs without a preset (LinkedIn banner, App Store screenshot, phone wallpaper). To refine one, call again with `from` (that variation's settings; you may edit them) and a brief such as 'warmer, more grain'. When refining, pass the current `sizes` from the widget's context too, so the person's chosen sizes stay. When the person pastes a design from the studio's 'Copy for ChatGPT' (a JSON block of Gradients Studio settings, or an older gradients.studio link), pass it as `link` or leave it in the brief; the widget opens that exact design, ready to approve. Never recreate it with image generation. Do not export until the person approves in the widget or says so in chat.

design_background

Use this when the person has approved a background from design_background and wants the files: they say so in chat ('export it', 'download the hero and OG sizes', 'save it into the repo'), or an 'Approved — export this background for …' message arrives from the widget. The widget normally exports by itself when the person presses Approve; that message means it could not (usually because the account is not connected yet). Pass the arguments exactly as the widget state's context gives them (do not retype or change values); otherwise the chosen variation's settings, the sizes, and `proposed` if given. Needs a connected Gradients Studio account; without one it asks the person to connect. Returns one download link per size with a suggested repo path. Coding agents: fetch each link into its path. Do not use this to show options, to start a new design, or before the person approves; use design_background for those.

export_background

Use this when the person wants to see what they can choose from before designing: 'what styles do you have?', 'show me some gradient palettes', 'show my saved palettes', 'what sizes can I export?'. Returns the studio's palettes, palettes inspired by well-known product sites (Linear, Stripe, Raycast, …), the size presets, and the person's saved palettes when connected. Do not call it before design_background as a matter of course: for 'a background like Linear's site', call design_background with the product named in the brief.

list_palettes