ShipScreens CLI

Use this when app-dev CI or MCP-enabled agents need deterministic store screenshot reruns as a build step.

Quickstart

npx --yes shipscreens@latest demo

Rendered mode (optional)

Rendered mode runs the UI renderer headlessly via Playwright Chromium. Install Chromium once per machine/CI runner:

npx playwright install --with-deps chromium

CI pipeline (copy/paste)

npx --yes shipscreens@latest validate
npx --yes shipscreens@latest lock
npx --yes shipscreens@latest copy check --strict --write-pseudo-csv out/copy-pseudo.csv --write-report-json out/copy-check-report.json
npx --yes shipscreens@latest build --out out --zip
npx --yes shipscreens@latest verify --out out --zip --profile appstore
npx --yes shipscreens@latest stage --from out --out out/stage --profile appstore

Docs: https://shipscreens.com/tools/agent-cli/

MCP server (stdio)

npx --yes shipscreens@latest mcp serve

Fastest workspace bootstrap:

npx --yes shipscreens@latest mcp init --client cursor
# use claude | vscode | gemini for other clients

Claude Code local setup (.mcp.json)

{
  "mcpServers": {
    "shipscreens": {
      "command": "npx",
      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
    }
  }
}

Windows users can force npx through cmd /c:

{
  "mcpServers": {
    "shipscreens": {
      "command": "cmd",
      "args": ["/c", "npx", "--yes", "shipscreens@latest", "mcp", "serve"]
    }
  }
}

Cursor project setup (.cursor/mcp.json)

{
  "mcpServers": {
    "shipscreens": {
      "command": "npx",
      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
    }
  }
}

VS Code Copilot workspace setup (.vscode/mcp.json)

{
  "servers": {
    "shipscreens": {
      "type": "stdio",
      "command": "npx",
      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
    }
  }
}

Gemini CLI setup (.gemini/settings.json in project or ~/.gemini/settings.json):

{
  "mcpServers": {
    "shipscreens": {
      "command": "npx",
      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
    }
  }
}

OpenAI Responses API note

• Default tool_choice=auto lets the model decide whether to call tools.
• Use tool_choice=required when the workflow must force a ShipScreens tool call.