Agent skill

Mobilecli

by mobile-next in mobile-next/mobilecli

Run mobile automation, app testing, and interact with iOS and Android devices, simulators, emulators, and apps using the mobilecli CLI tool or JSON-RPC API.

Custom licenceAuto-check: notesMobile

Install Mobilecli

skills CLI
$ npx skills add mobile-next/mobilecli --skill mobilecli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mobile-next/mobilecli mobilecli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mobile-next/mobilecli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mobilecli .claude/skills/mobilecli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mobilecli
GitHub stars
294
Token cost
~2.5k tokens
SKILL.md length
967 words
Files
2
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

Run mobile automation, app testing, and interact with iOS and Android devices, simulators, emulators, and apps using the mobilecli CLI tool or JSON-RPC API.

  • Works in 2 steps: Authenticate once → Allocate, use, release
  • This skill whenever the user wants to list connected devices
  • SKILL.md covers Install, Quick Start (TL;DR), AI Automation Workflows and Best Practices for AI Agents, plus 3 more sections
  • Calls npm, npx and brew; needs MOBILECLI_TOKEN

What it does

Mobilecli is an agent skill from mobile-next/mobilecli. Run mobile automation, app testing, and interact with iOS and Android devices, simulators, emulators, and apps using the mobilecli CLI tool or JSON-RPC API. Trigger this skill whenever the user wants to list connected devices, boot or shut down simulators/emulators, take mobile screenshots, start screen recordings, send key/touch inputs (tap, text, swipe, pinch, hardware buttons), manage apps (install, uninstall, launch, terminate, get foreground app), inspect webviews (query DOM, evaluate JS, navigate)…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Mobile, covering Mobile testing and debugging. It works with Android, iOS, npm and Xcode. The repository describes itself as: Universal command-line tool for managing iOS and Android devices, simulators, emulators and apps.

When your agent uses it

  • This skill whenever the user wants to list connected devices
  • Shut down simulators/emulators
  • Take mobile screenshots
  • Start screen recordings

Example prompts

  • “t explicitly name”
  • “/mobilecli”

Requirements

  • Node.js
  • A credential in MOBILECLI_TOKEN
  • Pre-approved tools (allowed-tools): Bash(mobilecli:*)

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Authenticate once
  2. Allocate, use, release

What it can do on your machine

Read from SKILL.md and the folder at commit aca77be. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(mobilecli:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MOBILECLI_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mobilecli loads about 2.5k tokens when it runs. Until then it costs about 194 tokens; SKILL.md has 967 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~194
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:22
    ls with a permissions error, retry with `sudo npm install -g mobilecli@latest` or ask the user. If `mobilecli` is not on

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 967 words (~2,492 tokens).

“A universal automation and management skill for iOS and Android devices, simulators, emulators, and mobile apps. This skill guides you through interacting with devices, automating applications, performing gestures, capturing screen states, inspecting webviews, using the mobilecli command-line interface.”

— opening of SKILL.md by mobile-next, Custom licence
name
mobilecli
allowed-tools
Bash(mobilecli:*)

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/mobilecli of mobile-next/mobilecli.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit aca77be

Compare with similar skills

Mobilecli next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mobilecli compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mobilecli this skillmobile-next/mobilecli294—~2.5kAutomated safety check: NotesCustom licence
Mobile App Debuggingsecondsky/claude-skills227—~513Automated safety check: PassMIT
MAUI Device Test Runnerdotnet/maui23k—~3.3kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca87k1 repos~584Automated safety check: PassApache-2.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
Mobilerun Docs Referencedroidrun/mobilerun9.6k—~943Automated safety check: PassMIT

Similar skills

  • Mobile App Debugging

    secondsky/claude-skills

    Mobile app debugging for iOS, Android, cross-platform frameworks.

    227 GitHub stars~513 tokensUpdated 9 days ago
    MobileAuto-check passed
  • Official

    Builds and runs .NET MAUI device tests locally on iOS simulators, MacCatalyst, Android emulators or Windows, with optional category filtering.

    23k GitHub stars~3.3k tokensUpdated today
    Testing & QAAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    87k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Mobilerun Docs Reference

    droidrun/mobilerun

    Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.

    9.6k GitHub stars~943 tokensUpdated 2 days ago
    MobileAuto-check passed
  • Appium

    blokadaorg/blokada

    A skill your agent uses for dynamic inspection and navigation of the Blokada app through the repo-local Appium machine session.

    3.3k GitHub stars~3.5k tokensUpdated today
    MobileAuto-check passed

Categories

Questions about Mobilecli

What does Mobilecli do?

Run mobile automation, app testing, and interact with iOS and Android devices, simulators, emulators, and apps using the mobilecli CLI tool or JSON-RPC API. Mobilecli is an agent skill from mobile-next/mobilecli. Run mobile automation, app testing, and interact with iOS and Android devices, simulators, emulators, and apps using the mobilecli CLI tool or JSON-RPC API.

When should I use Mobilecli?

Mobilecli fits situations like: this skill whenever the user wants to list connected devices; shut down simulators/emulators; take mobile screenshots; start screen recordings.

How do I install Mobilecli in Claude Code?

Run `npx skills add mobile-next/mobilecli --skill mobilecli -a claude-code`. Or copy the skill folder (skills/mobilecli in mobile-next/mobilecli) into .claude/skills/mobilecli in your project. Claude Code loads it when a task matches its description.

How do I install Mobilecli in Codex?

Run `npx skills add mobile-next/mobilecli --skill mobilecli -a codex`. Or copy the skill folder (skills/mobilecli in mobile-next/mobilecli) into .agents/skills/mobilecli in your project. Codex loads it when a task matches its description.

Can I use Mobilecli in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mobile-next/mobilecli --skill mobilecli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobilecli, .gemini/skills/mobilecli, .github/skills/mobilecli and .opencode/skills/mobilecli in your project.

What does Mobilecli need to run?

Going by SKILL.md and its folder, Mobilecli needs the command-line tools its instructions call (npm, npx and brew) and credentials named MOBILECLI_TOKEN. Our summary lists: Node.js; A credential in MOBILECLI_TOKEN. Its frontmatter pre-approves these tools: Bash(mobilecli:*).

Does Mobilecli access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Mobilecli safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Mobilecli use?

Mobilecli has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Mobilecli use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mobilecli?

Skills that share tags, products or a category with Mobilecli: Mobile App Debugging (secondsky/claude-skills, 227 stars), MAUI Device Test Runner (dotnet/maui, 23k stars), Orca iOS Simulator Control (stablyai/orca, 87k stars) and Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mobilecli?

mobile-next (a GitHub organization) maintains it in mobile-next/mobilecli, which has 294 GitHub stars. The repository was last updated on October 4, 2026.

Source: mobile-next/mobilecli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.