Skip to main content
Gemini CLI logo

Ship your mobile app from Gemini CLI with Capgo

Gemini CLI 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 Gemini CLI

Three steps or less. Copy each block as is.

  1. Step 1

    Add the hosted Capgo MCP

    Add the server for your user, then run /mcp auth capgo inside Gemini CLI to sign in. No API key needed.

    Terminal
    $ gemini mcp add --transport http -s user capgo https://api.capgo.app/mcp

  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.

    Terminal
    $ npx @capgo/cli@latest login $ gemini mcp add -s user capgo-cli npx @capgo/cli@latest mcp

  3. Step 3

    Install the Capgo skills

    Use the generic installer, or Gemini skill management: gemini skills install https://github.com/Cap-go/capgo-skills.

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

What you can ask Gemini CLI

Copy a prompt and paste it into Gemini CLI. 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.”

  • Observe

    “Which channels have a rollout paused right now, and why?”

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

Gemini CLI notes and limits

  • Editing settings.json by hand? Use httpUrl for the hosted server. The url key means SSE in Gemini CLI.
  • Gemini CLI runs shell commands, so it can call the Capgo CLI directly for anything the MCP does not cover.

FAQ

Capgo and Gemini CLI: common questions

Can Gemini CLI build my iOS app without a Mac?

Yes. Gemini CLI 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 Gemini CLI?

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 Gemini CLI roll back a bad update?

Yes. Ask Gemini CLI 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 Gemini CLI?

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 Gemini CLI

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

Docs

Related pages