init
Start a design session and return the session ID, canvas/repo context, and docs; call it first, then pass that ID to every edit or read call to scope state and cursor.
Instructions
Bootstrap a design session. Returns a unique session ID, session context (canvas ID, repo path), and documentation. Call this first. Pass the returned session ID as the sessionId argument on every subsequent edit / read call: this scopes your refs/design-system state AND gives you your own distinct labelled cursor on the canvas (concurrent agents that echo their IDs never share one cursor). Optionally pass a short agentName (2-3 words) to label that cursor. Pass project (a name or key from list_projects) to bind this session to a project OTHER than the one on screen — including a project that is not open, which the agent reaches headlessly, or the absolute path of a project folder Brilliant has not seen yet (a new Git worktree), which it opens and lists. If you CANNOT read images, pass vision: false: preview requests then return a textual render summary instead of an inline PNG. Then write with edit: an html fence for most tasks (no knowledge loading needed), a bl fence (Blueprint DSL) for advanced features and edits, with its knowledge loaded first via get_knowledge.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "init"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vision | No | Whether this client can READ inline images (default true). Set false if you cannot see images: preview requests (a `preview()` row) then return a compact TEXTUAL render summary: each element's bounds in parent and world space, layout/overflow checks, and a fill/text one-liner, in place of the inline PNG, so you can verify your write landed without seeing it. | |
| project | No | Optional project to bind this session to: an exact name or key from `list_projects`, or an unambiguous name/handle substring, or the absolute path of a project folder (one holding .bl files, or an empty one), which opens in the background and is added to list_projects. Defaults to the project currently on screen. An ambiguous or unknown value is refused with the candidates listed. | |
| agentName | No | Optional short display name (2-3 words) for this agent's canvas cursor. Clipped to 32 characters. |