mobbin-cli

KO | EN

gitlite — search

#python #hacktoberfest #react #llm #go #golang #deep-learning #linux #docker #macos #java #vue #ios #open-source

(★ 9)

Local Mobbin visual-search CLI with one-time OAuth login for agents and humans.

mobbin-cli 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Mobbin CLI

<p align="center">
  Mobbin visual search from your terminal. Log in once with Mobbin OAuth, store the token locally, and let agents search screens, flows, and page sections without keeping a Codex MCP server mounted.
</p>

## Overview

Codex MCP tools are great when they are active, but they also add startup clutter and depend on the agent client exposing the right tool surface. `mobbin-cli` keeps Mobbin access as a normal command:

- `mobbin login` opens Mobbin OAuth; no API key is required.
- OAuth-backed searches call Mobbin's MCP endpoint directly from the CLI.
- `MOBBIN_API_KEY` remains available as a CI or fallback path.
- JSON output is stable enough for agents to consume.
- `--download-dir` can save returned images for local visual inspection.

## Install

Install the CLI globally. Bun is recommended because the command runs on Bun:

```bash
bun add -g @opencoredev/mobbin-cli
mobbin --help
```

npm also works when Bun is already installed on your machine:

```bash
npm install -g @opencoredev/mobbin-cli
mobbin --help
```

## Agent Skill

Install the companion skill from skills.sh so agents know when and how to use the CLI:

```bash
npx skills add opencoredev/mobbin-cli@mobbin-cli --global --agent '*' --yes
```

Then ask the agent to use Mobbin for UI research, screen references, flows, or website sections. The skill teaches the agent to call the local `mobbin` command, inspect downloaded images, and cite Mobbin result URLs.

Copy this prompt into an agent to install everything:

```text
Install Mobbin CLI and the Mobbin agent skill for this machine. Use Bun to install @opencoredev/mobbin-cli globally, then install the skills.sh skill opencoredev/mobbin-cli@mobbin-cli globally for all supported agents. After installing, run mobbin status --check. If Mobbin is not logged in, run mobbin login and verify with: mobbin search "login screen" --platform ios --limit 1 --json.
```

## Login

```bash
mobbin login
```

The OAuth flow stores credentials in macOS Keychain when available. On other systems, or when requested with `--store file`, credentials are written to `~/.config/mobbin-cli/config.json` with `0600` permissions.

Check the saved login:

```bash
mobbin status --check
```

API-key fallback is supported for CI-style environments:

```bash
printf '%s' "$MOBBIN_API_KEY" | mobbin login --stdin
```

`MOBBIN_API_KEY` always overrides stored credentials.

## Search

```bash
mobbin search "login screen with biometric authentication" --platform ios --limit 5
mobbin search "checkout page with Apple Pay" --platform web --mode deep --limit 4 --json
mobbin screens search "settings screen with account security" --platform ios --download-dir /tmp/mobbin
mobbin flows search "onboarding with personalization steps" --platform ios --limit 3 --json
mobbin sections search "pricing page with plan comparison table" --limit 4 --json
```

Use `--json` for agent-readable output. Use `--mode deep` when the query needs intent matching rather than a quick layout pass.

## Auth Model

Credential precedence:

1. `MOBBIN_API_KEY`
2. OAuth or API-key credential stored by `mobbin login`
3. `~/.config/mobbin-cli/config.json`

OAuth credentials use:

```text
https://api.mobbin.com/mcp
```

API-key credentials use REST search endpoints such as:

```text
POST /v1/screens/search
POST /v1/flows/search
POST /v1/sections/search
```

## Project Structure

```text
bin/mobbin       npm executable wrapper
index.ts          executable entrypoint and public test exports
src/args.ts      CLI argument parsing
src/auth.ts      credential loading, login, validation, refresh
src/oauth.ts     browser OAuth and dynamic client registration
src/mcp.ts       direct JSON-RPC calls to Mobbin's MCP endpoint
src/http.ts      REST API requests and API errors
src/search.ts    search payloads, image download helpers, text output
src/commands.ts  command handlers
skills/          skills.sh agent skill package
```

## Development

```bash
git clone https://github.com/opencoredev/mobbin-cli.git
cd mobbin-cli
bun install
bun test
bun run check
bun run pack:check
mobbin status --check
mobbin search "login screen" --platform ios --limit 1 --json
```

The CLI is Bun-native and intentionally has no dev server. Keep examples copy-pasteable and avoid committing credentials from `~/.config/mobbin-cli`.

## Release

Releases use Changesets plus npm Trusted Publishing.

```bash
bun run changeset
```

The GitHub release workflow validates on the `DEPOT_RUNNER` repo/org variable, then creates a release PR or publishes from the `npm` environment. Set `DEPOT_RUNNER` to `depot-ubuntu-24.04` after the Depot runner is enabled for the repo; until then it falls back to `ubuntu-latest` so releases do not hang in the queue.

The npm trusted publisher should point at:

```bash
npm trust github @opencoredev/mobbin-cli --repo opencoredev/mobbin-cli --file release.yml --env npm --allow-publish
```

The package must exist on npm before `npm trust` can attach the trusted publisher.

mobbin-cli

mobbin-cli 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mobbin-cli

mobbin-cli 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README