Skip to main content

Use NextPush with AI coding agents

NextPush publishes a skill: one Markdown file that tells a coding agent (Claude Code, Cursor, Codex, Copilot, Windsurf, ...) everything it needs to set up and run OTA updates with NextPush: how to sign in without a browser, how to configure a React Native or Expo app, how to release, promote and roll back, and which rules to follow before touching Production.

The skill follows the open Agent Skills format (SKILL.md with name and description frontmatter), so tools that understand skills load it as one, and every other tool can read it as plain Markdown.

The one-line prompt​

Paste this into your agent in the project you want to update over the air:

Read https://nextpush.center/skill.md and follow it to set up NextPush OTA updates in this project.

The agent installs the CLI, signs in, creates the app and deployments, writes the native configuration and releases to Staging. It will ask you for the e-mail code once (see below) and before anything reaches Production.

Install the skill in a project​

Keeping a copy in the repository makes the agent pick it up automatically, offline, and lets you pin a version.

# Claude Code
mkdir -p .claude/skills/nextpush
curl -fsSL https://nextpush.center/skill.md -o .claude/skills/nextpush/SKILL.md

# Cursor / Windsurf
mkdir -p .cursor/rules
curl -fsSL https://nextpush.center/skill.md -o .cursor/rules/nextpush.mdc

# Codex, Copilot and others: append it to AGENTS.md or .github/copilot-instructions.md
curl -fsSL https://nextpush.center/skill.md >> AGENTS.md

Re-run the curl to update; the frontmatter carries the version.

Sign-in without a browser​

Agents cannot complete an OAuth flow, so the CLI (1.2.0+) signs in with a code sent by e-mail, in two commands:

nextpush login --email [email protected]          # mails a 6-digit code
nextpush login --email [email protected] --code 123456

The agent runs the first command, asks you for the code, and runs the second. The code lives 10 minutes and works once; the account is created on the first sign-in. In an interactive terminal the first command asks for the code directly. The same option exists on nextpush register, and the dashboard sign-in page offers "Continue with e-mail" as well.

What the skill tells the agent to do, and not to do​

  • Run nextpush whoami before anything else and sign in if needed.
  • Release to Staging by default; confirm with you before Production, rollbacks and mandatory releases.
  • Keep access keys out of chat, source files and git. Deployment keys belong in the native config and are fine.
  • Use nextpush <command> --help instead of guessing flags.
  • Report the label, deployment, target version and rollout after each release.
  • Hand billing to you: nextpush billing opens the billing page already signed in; the agent never pays.

Dashboard and billing from the CLI​

nextpush dashboard                  # app list, signed in
nextpush billing                    # Settings > Billing
nextpush billing --plan plus        # a plan's checkout page
nextpush billing --no-browser       # print the link instead

The link contains a one-time code that expires after 60 seconds; the dashboard exchanges it for its own session, so the CLI's access key never leaves your machine.

Keep the skill honest​

The skill is written by hand in this repository, and a test checks that every nextpush command it mentions exists in the CLI and that it names the current CLI version. If you find a mistake, write to [email protected].