Agent skill

OpenGUI Phone Remote Control

by Core-Mate in Core-Mate/OpenGUI

Lets a coding agent list, run, pause, resume or cancel natural-language tasks on an Android phone through the OpenGUI backend instead of raw ADB commands.

Custom licenceAuto-check: notesProductivity & Automation

Install OpenGUI Phone Remote Control

skills CLI
$ npx skills add Core-Mate/OpenGUI --skill open-gui-remote-control -a claude-code

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

GitHub CLI
$ gh skill install Core-Mate/OpenGUI open-gui-remote-control --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/Core-Mate/OpenGUI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/open-gui-remote-control .claude/skills/open-gui-remote-control && 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
open-gui-remote-control
GitHub stars
1.8k
Token cost
~2.6k tokens
SKILL.md length
1,179 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Lets a coding agent list, run, pause, resume or cancel natural-language tasks on an Android phone through the OpenGUI backend instead of raw ADB commands.

  • Works in 7 steps: Obtain the runnable checkout → Verify backend → Verify Android client → …
  • Running a natural-language task on an Android phone through OpenGUI
  • SKILL.md covers Trigger Guidance, Core Rules, Repository Source and Local Or Remote Workspace, plus 7 more sections
  • Calls pnpm, adb and git

What it does

Keeps the agent off direct `adb shell input` scripting, routing every phone action through a server CLI or REST API that talks to the OpenGUI backend's task and execution services. A runnable OpenGUI checkout is required first, used through its repository CLI, run as `cd server && pnpm opengui` with the desired subcommand, and the `--json` flag whenever the agent itself will parse the result rather than a person reading it.

Before running anything, the skill decides between a local or a remote workspace: local when the phone is connected by USB to the same machine and the agent has terminal access there, remote only when the user explicitly asks for a remote host that can reach the device or a device bridge and whose backend URL the Android client can reach. A separate bootstrap skill handles installing OpenGUI from scratch; this one takes over once the backend and Android client are already running.

Device presence from a devices listing is treated as standby only, since execution can still fail from model configuration, missing Android permissions, app state or the device's own lifecycle, so the agent is told to ask the user only for physical phone actions, permissions, or missing secrets rather than things it can run itself.

When your agent uses it

  • Running a natural-language task on an Android phone through OpenGUI
  • Checking the status of, pausing, or canceling an OpenGUI execution
  • Listing which Android devices are currently online in OpenGUI
  • Deciding whether OpenGUI should run locally or on a remote host

Example prompts

  • “List the OpenGUI devices that are online right now.”
  • “Use OpenGUI to open the camera app and take a photo on my phone.”
  • “Pause the current OpenGUI task, I need to answer a call.”

Requirements

  • A runnable OpenGUI checkout (server and client)
  • pnpm
  • An Android device reachable by the OpenGUI backend

Workflow steps

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

  1. Obtain the runnable checkout
  2. Verify backend
  3. Verify Android client
  4. List devices
  5. Dispatch the task
  6. Poll status
  7. Control the execution when needed

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm
    • adb
    • git
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, git and curl, 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 no API keys, tokens, secrets or passwords.

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

Context cost

OpenGUI Phone Remote Control loads about 2.6k tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 1,179 words of instructions outside code blocks.

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

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.

  • NoteMentions a .env fileSKILL.md:209
    If `start.sh` creates `.env` and exits, ask only for the missing model keys required for execution, then run it again.

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 1,179 words (~2,594 tokens).

“Use this skill when an AI coding agent such as Claude Code, Codex, or OpenCode needs to operate an Android phone through OpenGUI.”

— opening of SKILL.md by Core-Mate, Custom licence
name
open-gui-remote-control

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/open-gui-remote-control of Core-Mate/OpenGUI.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit f19a920

Compare with similar skills

OpenGUI Phone Remote Control 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.

OpenGUI Phone Remote Control compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OpenGUI Phone Remote Control this skillCore-Mate/OpenGUI1.8k—~2.6kAutomated safety check: NotesCustom licence
Burner Phone Android Controlsmallnest/goclaw598—~436Automated safety check: PassMIT
Skyvern Browser AutomationSkyvern-AI/skyvern23k1 repos~2.9kAutomated safety check: PassAGPL-3.0
N8n CLIn8n-io/n8n207k—~3kAutomated safety check: PassCustom licence
CUAWright Web Task Automationmicrosoft/CUAWright6k—~2kAutomated safety check: NotesMIT
Cherrypick Logkomikku-app/komikku4.8k—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Controls an Android device over ADB in a loop of screenshot, vision analysis, tap and verification, so the agent acts on real on-screen coordinates.

    598 GitHub stars~436 tokensUpdated 6 mo ago
    MobileAuto-check passed
  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Picks the right Skyvern CLI command for a web task, from quick yes/no checks to reusable multi-page workflows, instead of falling back to plain page fetching.

    23k GitHub starsUsed in 1 repo~2.9k tokens
    Productivity & AutomationAuto-check passed
  • N8n CLI

    n8n-io/n8n

    Official

    Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance.

    207k GitHub stars~3k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Official

    Solves web tasks by driving a local Playwright browser one bash command at a time, saving a reusable script, screenshots and an action log for each run.

    6k GitHub stars~2k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check: notes
  • Cherrypick Log

    komikku-app/komikku

    Update and review cherrypicklog.md, the todo list of upstream commits not yet cherry-picked into the fork's target branch.

    4.8k GitHub stars~1.9k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

    23k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from Core-Mate/OpenGUI

  • OpenGUI Bootstrap

    Core-Mate/OpenGUI

    Installs, configures and runs OpenGUI's backend and Android client from a plain-language request, running the repo's own setup scripts and asking the user only for physical phone steps or secrets.

    1.8k GitHub stars~1.7k tokensUpdated today
    Auto-check: notes
  • OpenGUI Installer for DSH

    Core-Mate/OpenGUI

    Installs and verifies the latest stable OpenGUI release in a DeepSeek Harness web profile on macOS without disturbing existing plugins or settings.

    1.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Controls an authorized local Android phone, or shows its live read-only video feed, for phone app tasks and Android UI checks on macOS.

    1.8k GitHub stars~762 tokensUpdated today
    Auto-check passed
  • Completes an already-authorized task on a real Android phone or a macOS iOS simulator one screenshot-driven action at a time.

    1.8k GitHub stars~7.7k tokensUpdated today
    Auto-check passed
  • OpenGUI Plugin Installer

    Core-Mate/OpenGUI

    Installs or upgrades the standalone OpenGUI plugin for Codex or WorkBuddy on macOS from verified prebuilt GitHub releases, checking the SHA-256 before running anything.

    1.8k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • OpenGUI Android Control

    Core-Mate/OpenGUI

    Drives locally connected Android phones through OpenGUI screenshots and allowlisted actions, one observed step at a time, for app, game and multi-device tasks.

    1.8k GitHub stars~788 tokensUpdated today
    Auto-check passed

Works with

Questions about OpenGUI Phone Remote Control

What does OpenGUI Phone Remote Control do?

Lets a coding agent list, run, pause, resume or cancel natural-language tasks on an Android phone through the OpenGUI backend instead of raw ADB commands. Keeps the agent off direct `adb shell input` scripting, routing every phone action through a server CLI or REST API that talks to the OpenGUI backend's task and execution services. A runnable OpenGUI checkout is required first, used through its repository CLI, run as `cd server && pnpm opengui` with the desired subcommand, and the `--json` flag whenever the agent itself will parse the result rather than a person reading it.

When should I use OpenGUI Phone Remote Control?

OpenGUI Phone Remote Control fits situations like: running a natural-language task on an Android phone through OpenGUI; checking the status of, pausing, or canceling an OpenGUI execution; listing which Android devices are currently online in OpenGUI; deciding whether OpenGUI should run locally or on a remote host.

How do I install OpenGUI Phone Remote Control in Claude Code?

Run `npx skills add Core-Mate/OpenGUI --skill open-gui-remote-control -a claude-code`. Or copy the skill folder (skills/open-gui-remote-control in Core-Mate/OpenGUI) into .claude/skills/open-gui-remote-control in your project. Claude Code loads it when a task matches its description.

How do I install OpenGUI Phone Remote Control in Codex?

Run `npx skills add Core-Mate/OpenGUI --skill open-gui-remote-control -a codex`. Or copy the skill folder (skills/open-gui-remote-control in Core-Mate/OpenGUI) into .agents/skills/open-gui-remote-control in your project. Codex loads it when a task matches its description.

Can I use OpenGUI Phone Remote Control 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 Core-Mate/OpenGUI --skill open-gui-remote-control -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/open-gui-remote-control, .gemini/skills/open-gui-remote-control, .github/skills/open-gui-remote-control and .opencode/skills/open-gui-remote-control in your project.

What does OpenGUI Phone Remote Control need to run?

Going by SKILL.md and its folder, OpenGUI Phone Remote Control needs the command-line tools its instructions call (pnpm, adb, git and curl). Our summary lists: A runnable OpenGUI checkout (server and client); pnpm; An Android device reachable by the OpenGUI backend.

Does OpenGUI Phone Remote Control access the network?

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

Is OpenGUI Phone Remote Control safe to install?

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

What licence does OpenGUI Phone Remote Control use?

OpenGUI Phone Remote Control 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 OpenGUI Phone Remote Control use?

About 2.6k 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 OpenGUI Phone Remote Control?

Skills that share tags, products or a category with OpenGUI Phone Remote Control: Burner Phone Android Control (smallnest/goclaw, 598 stars), Skyvern Browser Automation (Skyvern-AI/skyvern, 23k stars), N8n CLI (n8n-io/n8n, 207k stars) and CUAWright Web Task Automation (microsoft/CUAWright, 6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OpenGUI Phone Remote Control?

Core-Mate (a GitHub organization) maintains it in Core-Mate/OpenGUI, which has 1,815 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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