Agent skill

Deploy iOS

by gronxb in gronxb/codex-relay

Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater.

Apache-2.0Auto-check passedMobile

Install Deploy iOS

skills CLI
$ npx skills add gronxb/codex-relay --skill deploy-ios -a claude-code

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

GitHub CLI
$ gh skill install gronxb/codex-relay deploy-ios --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/gronxb/codex-relay.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deploy-ios .claude/skills/deploy-ios && 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
deploy-ios
GitHub stars
679
Token cost
~382 tokens
SKILL.md length
177 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater.

  • Works in 6 steps: Work from the mobile app directory → Read the current native app versions → Extract the current ios app version from… → …
  • The user invokes $deploy-ios
  • SKILL.md covers Workflow and Notes
  • Calls pnpm

What it does

Deploy iOS is an agent skill from gronxb/codex-relay. Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater. Use when the user invokes $deploy-ios or asks to deploy the current iOS app version from apps/mobile.

Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering iOS development and Deployment. It works with iOS. The repository describes itself as: Use Codex from your phone while the real work stays on your computer. The licence is Apache-2.0.

When your agent uses it

  • The user invokes $deploy-ios
  • Asks to deploy the current iOS app version from apps/mobile

Example prompts

  • “/deploy-ios”

Requirements

  • Pre-approved tools (allowed-tools): Bash(pnpm:*)

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Work from the mobile app directory
  2. Read the current native app versions
  3. Extract the current ios app version from the output. If --json is not supported, run pnpm hot-updater app-version and parse the iOS…
  4. Deploy iOS with the current iOS app version
  5. Wait for the command to finish. Do not stop at the build spinner.
  6. Report the deployment result

What it can do on your machine

Read from SKILL.md and the folder at commit 2a0cca2. 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(pnpm:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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

Deploy iOS loads about 382 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 177 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from gronxb/codex-relay at commit 2a0cca2, republished under its Apache-2.0 licence (© gronxb). 177 words, ~382 tokens.

Download SKILL.mdSave it as .claude/skills/deploy-ios/SKILL.md (or your agent's skills folder).
name
deploy-ios
description
Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater. Use when the user invokes $deploy-ios or asks to deploy the current iOS app version from apps/mobile.
allowed-tools
Bash(pnpm:*)

Deploy iOS OTA

Deploy the iOS Hot Updater OTA bundle for the mobile app.

Workflow

  1. Work from the mobile app directory:
bash
cd apps/mobile
  1. Read the current native app versions:
bash
pnpm hot-updater app-version --json
  1. Extract the current ios app version from the output. If --json is not supported, run pnpm hot-updater app-version and parse the iOS version from the human-readable output.

  2. Deploy iOS with the current iOS app version:

bash
pnpm hot-updater deploy -p ios -t <ios-app-version>
  1. Wait for the command to finish. Do not stop at the build spinner.

  2. Report the deployment result:

  • Success requires build complete, storage upload complete, database update complete, and Deployment Successful (...).
  • Include the Bundle ID from the deployment summary.
  • If it fails, report the failing phase and the relevant error output.

Notes

  • apps/mobule in user prompts means apps/mobile for this repo.
  • This command deploys to the configured Hot Updater production channel and targets the current iOS native app version.
  • Do not hardcode an app version in this skill. Always read the current iOS version at deploy time.
  • Do not change platform, rollout, channel, or environment unless the user explicitly asks.

© gronxb, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/deploy-ios of gronxb/codex-relay.

Open the folder on GitHubat commit 2a0cca2

Compare with similar skills

Deploy iOS 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.

Deploy iOS compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deploy iOS this skillgronxb/codex-relay679—~382Automated safety check: PassApache-2.0
ASC Ad Hoc Distributionrorkai/app-store-connect-cli-skills1.1k1 repos~1.8kAutomated safety check: PassMIT
Expo Deploymentkingstinct/react-native-healthkit7164 repos~930Automated safety check: PassMIT
App Store Deploymentsecondsky/claude-skills227—~799Automated safety check: NotesMIT
Releasemovieclaw/MovieClaw146—~2.6kAutomated safety check: PassCustom licence
CI CD Setuprshankras/claude-code-apple-skills783—~1.5kAutomated safety check: NotesMIT

Similar skills

  • ASC Ad Hoc Distribution

    rorkai/app-store-connect-cli-skills

    Prepares, publishes, resumes and verifies private iOS test installs for registered devices with `asc distribute`, using storage you own that speaks the S3 protocol.

    1.1k GitHub starsUsed in 1 repo~1.8k tokens
    MobileAuto-check passed
  • Expo Deployment

    kingstinct/react-native-healthkit

    Deploying Expo apps to iOS App Store, Android Play Store, web hosting, and API routes

    716 GitHub starsUsed in 4 repos~930 tokens
    MobileAuto-check passed
  • App Store Deployment

    secondsky/claude-skills

    Publishes mobile applications to iOS App Store and Google Play with code signing, versioning, and CI/CD automation.

    227 GitHub stars~799 tokensUpdated 10 days ago
    DevOps & CloudAuto-check: notes
  • Release

    movieclaw/MovieClaw

    发布 movieclaw 新版本。当用户要求发版、发布新版本、打 tag、发布 NER 模型、发布 Docker 镜像,或打包上传 iOS App 到 TestFlight / App Store、补传发版附件(IPA、Mac 转码器、Mac 版 App)时使用。涵盖版本号三处同步、应用/模型/镜像/iOS 的完整流程、可选附件失败补救与检查清单。

    146 GitHub stars~2.6k tokensUpdated today
    MobileAuto-check passed
  • CI CD Setup

    rshankras/claude-code-apple-skills

    Generate CI/CD configuration for automated builds, tests, and distribution of iOS/macOS apps.

    783 GitHub stars~1.5k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes
  • Wjs Auditing Project

    jianshuo/claude-skills

    A skill your agent uses when the user asks to audit what's wrong with a project, "make it right", "看看项目出了什么问题", "为什么用户的需求还没上线", "为什么没提交App Store", "为什么没新build", or wants a holistic…

    130 GitHub stars~2.5k tokensUpdated 1 mo ago
    MobileAuto-check passed

More from gronxb/codex-relay

  • Agent Cdp

    gronxb/codex-relay

    Chrome DevTools Protocol CLI workflow for runtime, console, network, trace, memory, and JavaScript CPU profiling analysis.

    679 GitHub stars~956 tokensUpdated yesterday
    Auto-check passed
  • Hot Updater

    gronxb/codex-relay

    Set up, upgrade, operate, and diagnose Hot Updater projects.

    679 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Hot Updater QA Ship

    gronxb/codex-relay

    Deploy the current Modex iOS app version with Hot Updater for QA-only delivery.

    679 GitHub stars~818 tokensUpdated yesterday
    Auto-check passed
  • Agent Device

    gronxb/codex-relay

    Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices.

    679 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Deploy iOS

What does Deploy iOS do?

Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater. Deploy iOS is an agent skill from gronxb/codex-relay. Deploy the Modex/Codex Relay mobile app iOS OTA update with Hot Updater.

When should I use Deploy iOS?

Deploy iOS fits situations like: the user invokes $deploy-ios; asks to deploy the current iOS app version from apps/mobile.

How do I install Deploy iOS in Claude Code?

Run `npx skills add gronxb/codex-relay --skill deploy-ios -a claude-code`. Or copy the skill folder (.agents/skills/deploy-ios in gronxb/codex-relay) into .claude/skills/deploy-ios in your project. Claude Code loads it when a task matches its description.

How do I install Deploy iOS in Codex?

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

Can I use Deploy iOS 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 gronxb/codex-relay --skill deploy-ios -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deploy-ios, .gemini/skills/deploy-ios, .github/skills/deploy-ios and .opencode/skills/deploy-ios in your project.

What does Deploy iOS need to run?

Going by SKILL.md and its folder, Deploy iOS needs the command-line tools its instructions call (pnpm). Its frontmatter pre-approves these tools: Bash(pnpm:*).

Does Deploy iOS access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Deploy iOS safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deploy iOS use?

Deploy iOS is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deploy iOS use?

About 382 tokens (SKILL.md is roughly 1.5k 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 Deploy iOS?

Skills that share tags, products or a category with Deploy iOS: ASC Ad Hoc Distribution (rorkai/app-store-connect-cli-skills, 1.1k stars), Expo Deployment (kingstinct/react-native-healthkit, 716 stars), App Store Deployment (secondsky/claude-skills, 227 stars) and Release (movieclaw/MovieClaw, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deploy iOS?

gronxb (a GitHub user) maintains it in gronxb/codex-relay, which has 679 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

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