stitch-cli

cli-web-stitch

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

Commands

| Command | Purpose | Key options | |---------|---------|-------------| | projects create PROMPT | New project + first design generation | --platform app\|web, --wait/--no-wait | | projects list\|get\|rename\|duplicate\|delete | Manage projects | rename takes NEW_NAME; delete takes -y/--yes | | projects download PROJECT_ID | Download all screen HTML files | -o/--output DIR | | design generate PROMPT | Generate/modify design with an AI prompt | --project ID, --model flash\|pro\|redesign, --device mobile\|web\|tablet\|agnostic, --wait/--no-wait, --retry N | | design theme | Design system (colors, typography) for a project | --project ID | | design history | Generation sessions (prompt history) | --project ID | | screens list\|get\|download SCREEN_ID | View/save generated screens | --project ID, -o/--output | | use PROJECT_ID / status | Set/show active project context | once set, --project is optional |

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.