pitolet

List open Pitolet documents with ids and frame counts.

List the top-level frames in a document with their ids, names, sizes, and child counts.

Return a compact node summary. Use get_design_as_code for complete generated code.

The user's current selection in the open editor (summaries, depth 1).

Design tokens (colors, spacing, radius, shadows, typography) as compact path: value lines.

Return a node subtree as React with Tailwind or HTML with CSS.

Create a new, empty Pitolet document (with the default token set). Returns its id; use create_frame next.

Select nodes in the open editor.

Render a frame as a JPEG for visual review. Set viewportWidth to inspect a responsive breakpoint and state to force hover, focus, or active styling.

Create a new top-level frame (artboard). Auto-placed right of existing frames unless x/y given.

Insert a subtree into a container. Each node may include type, tag, name, text, styles, and children. Returns the ids of the new root nodes.

Rename a Pitolet document. Returns the updated name and revision.

Delete a document created by mistake or a failed attempt. Requires its exact current name and refuses while an editor has it open.

Update a node: name, tag, visible, text content, and/or styles (deep-merged into base/breakpoints/states layers). Only pass what changes.

Delete ordinary nodes and their subtrees. Component masters and component content roots are protected.

Export the document as a code project with a manifest for drift checks. Set annotate=true to add source node ids to JSX.

Compare the current document and project files with the last export. Returns in-sync, design-updated, file-edited, both, or missing for each file.

Import design tokens from CSS. Pass Tailwind v4 @theme or :root variables with --color-*, --spacing-*, --radius-*, --shadow-*, --font-*, or --text-* prefixes. Existing token names are overwritten.

Add a comment to a node in the editor.

List comments, optionally filtered by node.

Mark a comment as resolved (e.g. after addressing its request).

Merge design-token changes. Set a token to null to delete it. Updates appear on every bound layer.