Productivity

Mobbin

mobbin-pp-cli

Every Mobbin screen, flow, and pattern — searchable offline, deckable in one command, with longitudinal drift no Mobbin tool ships.

Printed by @darinkishore (Darin Kishore)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install mobbin

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-mobbin --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-mobbin skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-mobbin. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

Every Mobbin screen, flow, and pattern — searchable offline, deckable in one command, with longitudinal drift no Mobbin tool ships.

Wraps Mobbin's curated library of shipped UI (web + mobile) with a local SQLite mirror, full-res batch downloads from the Bytescale CDN, and time-windowed audits across apps. Built for the Wednesday design crit and the quarterly onboarding audit. Uses your existing Chrome session via auth login --chrome — no extra API key, no paid MCP.

Authentication

Mobbin has no public API key. The CLI imports your logged-in Chrome cookies via pycookiecheat, cookies, or cookie-scoop-cli (one is required). Run mobbin-pp-cli auth login --chrome and the CLI handles the split Supabase JWT cookies (sb-ujasntkfphywizsdaapi-auth-token.0 / .1) and refreshes them automatically. Free-tier sessions work for trending / discover / popular / filters; full content search and per-app HTML scraping need a Mobbin Pro session.

Quick Start

# Import your logged-in Mobbin Chrome cookies (multi-profile aware)
mobbin-pp-cli auth login --chrome

# Verify auth + reachability before anything else
mobbin-pp-cli doctor

# Trending apps — public, works without auth; smoke-test the install
mobbin-pp-cli trending apps --platform web --agent

# Discover category slugs before filtering search
mobbin-pp-cli filters list --agent --select data.appCategories

# Cross-app pattern search — the foundational deck-building call
mobbin-pp-cli screens --platform web --screen-patterns paywall --agent --select data.id,data.appName,data.imageUrl

# One-shot design crit deck with full-res images + manifest CSV
mobbin-pp-cli deck "fintech paywalls" --platform web --limit 20 --export-zip ./deck.zip

Unique Features

These capabilities aren't available in any other tool for this API.

Design crit workflows

deck — Build a design-crit deck for a pattern across an industry: searches matching screens, downloads full-res images from the Bytescale CDN, packages a zip with a manifest CSV.

Replaces the 20-tab screenshot-and-rename loop designers do every crit week with one command and a reproducible artifact.
```
mobbin-pp-cli deck "fintech paywalls" --platform web --limit 20 --export-zip ./deck.zip --agent
```
bench — Cross-app leaderboard for any pattern from the local store: count, last seen, top apps that ship it.

Answers "who has shipped this pattern lately?" instantly without re-scrolling Mobbin's UI.
```
mobbin-pp-cli bench --pattern paywall --industry fintech --platform web --agent
```
grab — Batch-download matching screens at 1920px from Bytescale with deterministic filenames and a manifest.json side-car for downstream tooling.

Replaces hand-dragging 20 PNGs into Finder. The manifest.json is what Figma/Storyboard plugins consume.
```
mobbin-pp-cli grab --pattern empty-state --platform web --industry fintech --out ./refs --rename '{app}_{pattern}_{idx}.png'
```
cross — Fan out a pattern query across web AND iOS for one app set; join results on app slug; output a side-by-side parity manifest.

Web product designers checking whether the iOS reference still matches the desktop pattern. The user's explicit dual-platform ask.
```
mobbin-pp-cli cross "paywall" --apps stripe,linear,figma --agent
```

Longitudinal analysis

audit — Time-windowed flow audit across an industry: app, flow name, step count, captured_at — with --since support for delta-since-last-quarter reports.

Quarterly onboarding/checkout/empty-state audits stop being a manual diff against last quarter's Notion doc.
```
mobbin-pp-cli audit onboarding --platform web --industry b2b-saas --since 60d --agent --select app,flow,step_count,captured_at
```
drift — Diff an app's flows + screens between local snapshots; surface what changed (added/removed/screen count).

Tracks competitor product evolution. "What did Stripe ship since last month?" was unanswerable before.
```
mobbin-pp-cli drift stripe-web --since 30d --agent
```

Recipes

Wednesday paywall deck

mobbin-pp-cli deck "fintech paywalls" --platform web --limit 20 --export-zip ./paywall-deck-$(date +%Y%m%d).zip

Date-stamped zip with full-res PNGs and a manifest CSV — drag straight into Figma for the design crit.

Cross-platform pattern parity

mobbin-pp-cli cross "empty-state" --apps stripe,linear,figma --agent --select app,platform,screen_id

Web + iOS in one fan-out; the join on app slug is what makes parity comparisons cheap.

Quarterly onboarding audit

mobbin-pp-cli audit onboarding --platform web --industry b2b-saas --since 90d --agent --select app,flow,step_count,captured_at

Returns only flows captured in the last 90 days, grouped by app — drop into a CSV diff to show your PM what's changed.

Narrow a verbose screen response

mobbin-pp-cli screens --platform web --screen-patterns paywall --agent --select data.id,data.appName,data.imageUrl,data.screenPatterns

Screen-search payloads ship ~30 fields per row; --select with dotted paths keeps only the four agents actually need, cutting context burn ~85%.

Bench a pattern

mobbin-pp-cli bench --pattern checkout --industry e-commerce --platform web --agent

Local-SQL aggregate: count of screens per app, latest captured_at. Answers "who's shipping checkout flows lately?" without re-scrolling Mobbin.

Usage

Run mobbin-pp-cli --help for the full command reference and flag list.

Paths & environment variables

This CLI separates local files into four path kinds:

Kind	Contents
`config`	User-editable settings such as `config.toml` and saved profiles
`data`	Durable local data: `credentials.toml`, `data.db`, cookies, browser-session proof files, and other auth sidecars
`state`	Runtime state such as persisted queries, jobs, and `teach.log`
`cache`	Regenerable HTTP/cache files

Each kind resolves independently. The ladder is:

Per-kind env var: MOBBIN_CONFIG_DIR, MOBBIN_DATA_DIR, MOBBIN_STATE_DIR, or MOBBIN_CACHE_DIR
--home <dir> for this invocation
MOBBIN_HOME for a flat relocated root
XDG env vars: XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, XDG_CACHE_HOME
Platform defaults matching existing installs

For containers and agent sandboxes, prefer a single relocated root:

export MOBBIN_HOME=/srv/mobbin
mobbin-pp-cli doctor

Under MOBBIN_HOME=/srv/mobbin, the four dirs resolve to /srv/mobbin/config, /srv/mobbin/data, /srv/mobbin/state, and /srv/mobbin/cache.

MCP servers do not receive CLI flags from the host. Put relocation in the host env block:

{
  "mcpServers": {
    "mobbin": {
      "command": "mobbin-pp-mcp",
      "env": {
        "MOBBIN_HOME": "/srv/mobbin"
      }
    }
  }
}

Precedence matters in fleets: an ambient per-kind variable such as MOBBIN_DATA_DIR overrides an explicit --home for that kind. Use MOBBIN_HOME or the per-kind variables for durable fleet relocation; treat --home as the weaker per-invocation lever.

Relocation is one-way. Unsetting MOBBIN_HOME does not move files back to platform defaults, and doctor cannot find credentials left under a former root. Move the files manually before unsetting relocation variables.

Existing installs keep working because the platform-default rung matches the legacy layout. On the first auth write, stored secrets leave config.toml and are consolidated into credentials.toml under the data directory. Run mobbin-pp-cli doctor --fail-on warn to check path and credential-location warnings in automation.

Commands

apps

Browse and search apps in Mobbin's library (web, iOS, Android).

mobbin-pp-cli apps discover - Paginated discover-page apps. Tabs are latest / popular / animations.
mobbin-pp-cli apps list - List every app for a platform. Returns a flat array of {id, appName, platform, ...}. Large response (~1,000+ apps); cache locally for autocomplete.
mobbin-pp-cli apps popular - Popular apps grouped by category with preview screenshots. Web's the default; pair with --platform ios or android for mobile.
mobbin-pp-cli apps search - Authenticated app search with category filters. Requires Mobbin Pro session (run mobbin-pp-cli auth login --chrome first).

autocomplete

Cross-entity autocomplete search across apps, screens, and flows.

mobbin-pp-cli autocomplete - Fast autocomplete across apps, screens, and flows. Returns matching IDs grouped by relevance. Requires Mobbin Pro session for full result quality.

collections

Manage your saved Mobbin collections (decks of screens, flows, or apps). Read endpoints hit mobbin.com/api; write endpoints hit Supabase PostgREST directly (auth-token + apikey).

mobbin-pp-cli collections add-app - Add an app to a collection.
mobbin-pp-cli collections add-flow - Add a flow to a collection.
mobbin-pp-cli collections add-screen - Add a screen to a collection.
mobbin-pp-cli collections contents - Items inside a collection, paginated. Bucketed by --content-type and --platform-type.
mobbin-pp-cli collections create - Create a new collection in the authenticated user's workspace. Writes hit Supabase PostgREST directly (Bearer + apikey headers).
mobbin-pp-cli collections delete - Delete a collection. Uses PostgREST filter ?id=eq..
mobbin-pp-cli collections list - All collections owned by the authenticated user.
mobbin-pp-cli collections remove-screen - Remove a screen from a collection.

filters

Browse the filter taxonomy — every app category, screen pattern, UI element, and flow action with definitions and content counts.

mobbin-pp-cli filters - Full filter taxonomy. Returns the dictionary that powers every search filter — patterns, elements, categories, flow actions, definitions, and content counts.

flows

Search and browse user-flow recordings (onboarding, checkout, settings).

mobbin-pp-cli flows - Cross-app flow search. Filter by --flow-actions like 'creating-account' or 'subscribing'. Requires Mobbin Pro session.

screens

Search and inspect individual screens. Filter by pattern, element, OCR keywords, and app category.

mobbin-pp-cli screens - Cross-app screen search. Use --screen-patterns 'paywall' or --screen-elements 'search-bar' to filter. Requires Mobbin Pro session.

sites

Web sites in Mobbin's library (the web-app equivalent of apps for mobile).

mobbin-pp-cli sites - Full searchable-sites list for the web experience.

mobbin-pp-cli trending apps - Trending apps for a platform — what's hot this week on Mobbin.
mobbin-pp-cli trending filter-tags - Trending filter tags — patterns, elements, or categories users search for right now.
mobbin-pp-cli trending keywords - Trending OCR keywords found inside screenshots — what text-in-screenshots users are searching.
mobbin-pp-cli trending sites - Trending web sites (web-only surface).

workspaces

List your Mobbin workspaces. The default workspace is required to create collections.

mobbin-pp-cli workspaces - All workspaces the authenticated user belongs to.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
mobbin-pp-cli apps list mock-value

# JSON for scripting and agents
mobbin-pp-cli apps list mock-value --json

# Filter to specific fields
mobbin-pp-cli apps list mock-value --json --select id,name,status

# Dry run — show the request without sending
mobbin-pp-cli apps list mock-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
mobbin-pp-cli apps list mock-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries and add --ignore-missing to delete retries when a no-op success is acceptable
Confirmable - --yes for explicit confirmation of destructive actions
Piped input - write commands can accept structured input when their help lists --stdin
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

mobbin-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Run mobbin-pp-cli doctor to see the resolved config, data, state, and cache directories. The platform-default config path is ~/.config/mobbin-pp-cli/config.toml; --home, MOBBIN_HOME, and per-kind env vars can relocate it.

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Authentication errors (exit code 4)

Run mobbin-pp-cli doctor to check credentials Not found errors (exit code 3)
Check the resource ID is correct
Run the list command to see available items

API-specific

auth login --chrome says "No cookie extraction tool found" — Install one: pip install pycookiecheat (recommended), brew install barnardb/cookies/cookies, or cargo install cookie-scoop-cli.
401 after working for a few minutes — Supabase access token expired. Run mobbin-pp-cli auth login --chrome again to refresh; the daily-refresh fragility is a known Mobbin pattern.
screens search returns empty or fewer results than expected — You may be on Mobbin's free tier (latest 4 apps only). mobbin-pp-cli doctor reports your plan. Upgrade to Pro at https://mobbin.com/pricing for full library access.
grab or deck images are lower resolution than expected — Images are fetched full-width (1920px) from the Bytescale CDN as WebP; 1920px is the max Mobbin serves for these screens, so there is no higher-DPI flag.
drift reports "no prior snapshot" — Drift compares local snapshots over time. Run mobbin-pp-cli sync <slug> at least twice (separated by enough days) before expecting a diff.

Sources & Inspiration

This CLI was built by studying these projects and resources:

underthestars-zhy/MobbinAPI — Swift (39 stars)
pdcolandrea/mobbin-mcp — TypeScript (35 stars)
ismailsaleekh/mobbin-agent — TypeScript
solejay/mobbin-cli — JavaScript
YonasValentin/design-inspiration-mcp-server — TypeScript

Generated by CLI Printing Press