mobbin-axi
v0.1.4
Published
AXI-compliant Mobbin CLI for agents — token-efficient TOON output over Mobbin's MCP
Maintainers
Readme
mobbin-axi
Agent-ergonomic CLI for Mobbin — search real-world UI/UX patterns from production apps and websites, designed for AI agents. Built on the AXI principles: token-efficient TOON output, minimal schemas, contextual next-step suggestions, and structured errors.
It wraps Mobbin's OAuth-gated MCP server as a scriptable, headless CLI so any agent can research design patterns via plain shell commands — no MCP client required.
Install
npm install -g mobbin-axi
# or run on demand, no install:
npx -y mobbin-axi <command>Authenticate (one time)
mobbin-axi loginOpens your browser for Mobbin's OAuth flow (on headless/WSL it prints a URL to
paste). Tokens are stored at ~/.config/mobbin-axi/credentials.json and
refreshed automatically. mobbin-axi logout clears them; mobbin-axi auth status
reports state.
Commands
mobbin-axi dashboard + next-step hints
mobbin-axi screens "<description>" search UI screens (defaults to --platform ios)
mobbin-axi flows "<description>" search multi-step user flows
mobbin-axi sections "<description>" search website sections
mobbin-axi login | logout | auth status authentication
mobbin-axi setup hooks install SessionStart ambient-context hooks
mobbin-axi help [command] usageFlags
--platform ios|web— platform forscreens/flows(defaultios; Mobbin has no Android in the MCP).--limit N— cap results.--download— fetch the result screenshots into~/.cache/mobbin-axi/images/and print local file paths you can open/read.--full— disable text truncation.--json— raw structured output instead of TOON.
Examples
mobbin-axi screens "login screen with biometric authentication" --platform ios --limit 5
mobbin-axi screens "checkout with Apple Pay" --download
mobbin-axi flows "onboarding with personalization" --platform ios
mobbin-axi sections "pricing page with plan comparison"Describe one screen/flow/section in plain language; name an app to filter
(e.g. "Spotify now-playing screen"). Every response ends with a help: block
of suggested next commands.
License
MIT
