cli-web-stitch

Generate and manage Google Stitch AI UI designs. Requires Google SSO auth (auth login). Install: pip install cli-web-stitch

Commands

Examples

# Create a mobile app design and wait for generation
cli-web-stitch projects create "A fitness tracking app" --platform app --wait --json

# Set context, then iterate on the design
cli-web-stitch use <project-id>
cli-web-stitch design generate "Add a dark header with a search bar" --model pro --wait --json

# List screens and download all HTML exports
cli-web-stitch screens list --json
cli-web-stitch projects download <project-id> -o ./stitch-export --json

# Inspect the project's design system
cli-web-stitch design theme --json

JSON output

Every command accepts --json. Success responses are {"success": true, "data": ...}; errors are {"error": true, "code": "...", "message": "..."}.

Auth

cli-web-stitch auth login            # browser-based Google SSO (--headed default, --headless available)
cli-web-stitch auth status --json
cli-web-stitch auth import FILE      # import cookies from a JSON file

Run doctor to diagnose auth setup. For CI, set CLI_WEB_STITCH_AUTH_JSON with the cookies JSON.

Utilities

cli-web-stitch doctor [--json] self-diagnoses the local setup (install, auth, dependencies). cli-web-stitch mcp-serve serves the commands as MCP tools over stdio.

Agent tips

• Use --wait on projects create and design generate — generation is async and the CLI polls with backoff (--retry N for rate limits).
• projects create controls platform (--platform app|web); design generate controls model and device type.
• Grab IDs from projects list / screens list JSON (.data[].id), then use <project-id> to avoid repeating --project.