Skip to main content
Codex logo

Ship your mobile app from Codex with Capgo

Codex builds, publishes, and live-updates your Capacitor app: iOS and Android builds without a Mac, OTA fixes in minutes, one-click rollback.

  • CLI agent
  • Hosted MCP
  • Local MCP
  • Skills
  • CLI

Set up Capgo in Codex

Three steps or less. Copy each block as is.

  1. Step 1

    Add the hosted Capgo MCP

    Add the server, then sign in. Codex opens the Capgo consent page in your browser. No API key needed.

    Terminal
    $ codex mcp add capgo --url https://api.capgo.app/mcp $ codex mcp login capgo

  2. Step 2

    Add the local CLI MCP for builds and uploads

    Log in once with a Capgo API key, then register the local server. Codex stores both in ~/.codex/config.toml.

    Terminal
    $ npx @capgo/cli@latest login $ codex mcp add capgo-cli -- npx @capgo/cli@latest mcp

  3. Step 3

    Install the Capgo skills

    Codex loads skills from .agents/skills. The installer puts them there for you.

    Terminal
    $ npx skills add Cap-go/capgo-skills

What you can ask Codex

Copy a prompt and paste it into Codex. Replace the app ID and versions with yours.

  • Build

    “Build a signed iOS release of this app with Capgo Build.”

  • Publish

    “Request an Android release build and send it to the Google Play internal track.”

  • Update

    “Check if this change needs a native build or can ship as a live update.”

  • Update

    “Build the web app and push this fix to the production channel.”

  • Rollback

    “Roll back the last bundle on the production channel.”

  • Observe

    “Show update stats for v2.3.0: how many devices have it and how many failed.”

  • Observe

    “Why did my last iOS build fail? Read the build logs and suggest a fix.”

  • Update

    “Upload this build to a new beta channel and give me a QR code to test it.”

The full release loop

One account covers every step, from the first build to the next live fix.

  1. 1

    Build

    Signed iOS and Android builds in the cloud. No Mac and no Xcode on your side.

    Capgo Build for native apps
  2. 2

    Publish

    Send builds to TestFlight and Google Play, or submit them for store review.

    Build and publish iOS apps without a Mac
  3. 3

    Update

    Push JavaScript, HTML, and CSS fixes to a channel in minutes. Roll back in one step.

    Capgo live updates
  4. 4

    Observe

    See who got the update, what failed, and how each release performs.

    Capgo Observe

Codex notes and limits

  • Codex runs commands in your terminal, so it can build, upload, and roll back with the Capgo CLI too.
  • Prefer editing config? Add [mcp_servers.capgo] with url = "https://api.capgo.app/mcp" to ~/.codex/config.toml, then run codex mcp login capgo.
  • Do not skip codex mcp login: without it, Codex connects without signing in and the Capgo tools cannot reach your account.
  • The same config works in the Codex IDE extension and the Codex app.

FAQ

Capgo and Codex: common questions

Can Codex build my iOS app without a Mac?

Yes. Codex runs the Capgo CLI, which uploads your project to Capgo Build. Capgo signs and builds the iOS and Android apps in the cloud and can send them to TestFlight and Google Play.

Native build docs

Do I need a Capgo API key for Codex?

No API key needed for the hosted MCP: it signs in with OAuth. The local CLI MCP and the CLI use an API key that you save once with npx @capgo/cli@latest login. Create the key in the Capgo console under Settings, Organization, API keys.

Create a Capgo API key

Can Codex roll back a bad update?

Yes. Ask Codex to point the channel back to the previous bundle. Devices switch on their next update check. The Capgo updater also rolls back on its own when a new bundle fails to start.

Live update docs

Are live updates allowed on the App Store and Google Play?

Yes, for the web layer: JavaScript, HTML, CSS, and assets. Native code, new permissions, and new plugins still need a store release, which Capgo Build can make for you.

What does it cost to use Capgo from Codex?

The MCP servers, skills, and CLI are free to use. You need a Capgo plan, and every plan starts with a 14-day free trial with no credit card. Builds, live updates, and Observe are in every plan.

Pricing

Ship your next release from Codex

Create a Capgo account, connect Codex, and push your first build or live update today.

Docs

Related pages