New here? The quickstart walks this flow with
screenshots. This page is the depth behind it.
Starting a build
Integrations → Custom → Build anything. One input box takes two kinds of input:
Brief it like a contractor: what to track or fetch, what each action should do,
what you want to see in the notch.
Quick decisions
Before writing any code, the Studio researches the service behind your brief — real endpoints, auth model, gotchas — and asks up to four multiple-choice questions about anything that would change what gets built.- The recommended answer is listed first; every question also takes free text.
- Start building turns your answers into build requirements.
- Skip — build as described is fine for simple briefs.
While it builds
The modal splits — log and tools on the left, a live notch preview on the right where cards appear as they’re designed. Phases are visible: planning, generating, validating (with automatic fix rounds), installing the draft, drawing an icon, design review.The design pass
The Studio makes it match the brand, not just work. It resolves the company behind your integration, fetches the real logo for the icon, screenshots the service’s site, picks one accent color, and designs each action’s card against VoiceOS’s card-design rules. Then it screenshots every card exactly as the notch renders it, critiques the result, and applies styling fixes — up to three rounds, on first builds only.Test-driving
The preview runs real agent turns scoped to your draft: type or say an utterance, the agent picks a tool, acting tools park on their real confirmation cards, approved tools execute against your draft server.- Click any row in Tools to stage that action’s card — confirmation cards for acting tools, live results for reads.
- Required fields (API keys and options your integration declared) sit above the tools list. Fill them and the draft relaunches with the values — then the Studio quietly runs each read tool once to show real data.
- Each action has an Asks first toggle controlling its confirmation.
Refining
The footer field takes change requests: “add a delete action”, “show the streak too”. Each refine rebuilds the integration with your feedback while keeping its identity — name, icon, and your setup values survive.Saving, editing, and the handoff
Every generated folder ships with an
AGENTS.md that teaches the whole
integration contract — so the Studio and your editor can take turns on the same
folder.
Name and icon
- Name — editable in the modal header while a draft is open.
- Icon — hover it for a regenerate prompt. Describe exactly what you want
(“hand-drawn orange cat on cream, no gradient”), or ask for a real brand
mark (“use the Notion logo”, or just paste
linear.app). See Branding.
Under the hood
Everything the Studio generates uses the same manifest, tools, and cards
documented in the rest of this section.

