---
name: Google Stitch CLI
slug: google-stitch-cli
category: AI Engineering
description: Google Stitch CLI drives Google Stitch from the terminal to create and edit UI designs from prompts. Use it to manage Stitch projects, iterate on screens, and download generated HTML when working with AI mockups.
github: "https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/stitch-cli"
language: Python
stars: 215
forks: 45
install: "npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/stitch-cli ~/.claude/skills/stitch-cli"
installs_to: ~/.claude/skills/stitch-cli
source_path: .claude/skills/stitch-cli/SKILL.md
collection_size: 25
category_size: 2970
collection_url: "https://dirskills.com/collections/ItamarZand88/CLI-Anything-WEB"
added: 2026-09-04T05:25:49.809Z
last_synced: 2026-09-04T05:25:49.809Z
canonical_url: "https://dirskills.com/skills/google-stitch-cli"
---

# Google Stitch CLI

Google Stitch CLI drives Google Stitch from the terminal to create and edit UI designs from prompts. Use it to manage Stitch projects, iterate on screens, and download generated HTML when working with AI mockups.

**Install:**

```bash
npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/stitch-cli ~/.claude/skills/stitch-cli
```

## README

# cli-web-stitch

Generate and manage Google Stitch AI UI designs. Requires Google SSO auth (`auth login`).
Install: `pip install "cli-web-stitch[auth]"`, then `playwright install chromium`.

## 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

```bash
# 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

```bash
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`.