deploygate

DeployGate Agent Plugin

DeployGate agent integration for Claude Code and Codex: upload mobile apps, manage distribution pages, set up CI/CD, and onboard your team. Supports iOS (IPA) and Android (APK/AAB).

Installation

This repository includes plugin metadata for both Claude Code and Codex:

• Claude Code: plugin/.claude-plugin/plugin.json and .claude-plugin/marketplace.json
• Codex: plugin/.codex-plugin/plugin.json and .agents/plugins/marketplace.json

Claude Code

Add the marketplace and install the plugin from within Claude Code:

/plugin marketplace add DeployGate/deploygate-agent-plugin
/plugin install deploygate@deploygate-marketplace

Codex

Add the marketplace from your shell:

codex plugin marketplace add DeployGate/deploygate-agent-plugin

Then enable or install the deploygate plugin from the configured DeployGate marketplace in Codex.

Getting Started

After installation, start the guided onboarding flow:

• Claude Code: run /deploygate:setup
• Codex: mention $deploygate:setup

1. Account creation — sign in via browser-based device authorization (login_start → approve in browser → login_wait)
2. App upload — build and upload your IPA/APK/AAB
3. Distribution page — create a distribution page with an install link
4. Notifications — connect Slack/Teams/Chatwork
5. iOS device setup — UDID registration for Ad Hoc builds (if applicable)

Authentication

The plugin signs you in to DeployGate via a browser-based device authorization code:

1. Ask your agent to set up DeployGate. Under the hood it calls the login_start tool, which returns a URL and a short code.
2. Open the URL in a browser where you are signed in to DeployGate and click approve.
3. The agent calls login_wait, which returns your workspace information once you approve.

The issued token is stored at ~/.config/deploygate/token (on Windows, %APPDATA%\deploygate\token) with 0600 permissions and reused across sessions. Run the logout tool to revoke it server-side and delete the local file.

Skills

Claude Code invokes plugin skills as slash commands. Codex invokes plugin skills by mentioning the skill name with $.

Skill	Claude Code	Codex	Description
setup	/deploygate:setup	$deploygate:setup	Full onboarding flow with step-by-step progress display
deploy	/deploygate:deploy	$deploygate:deploy	Build and upload the current project to DeployGate
ci-setup	/deploygate:ci-setup	$deploygate:ci-setup	CI/CD integration — GitHub Actions, Bitrise, CircleCI (see external CI guide)
sdk-setup	/deploygate:sdk-setup	$deploygate:sdk-setup	Android SDK integration (crash reporting, screen capture). iOS SDK is currently not recommended.

MCP Tools

Authentication

Tool	Description
login_start	Begin a browser-based device authorization login. Returns a URL for the user to open and approve.
login_wait	Poll until the user approves login_start. On success, persists the token to ~/.config/deploygate/token (0600).
logout	Revoke the stored token on the server and delete the local token file.
get_user_info	Get current user information (workspace names, projects). Auto-clears the local token on a 401 response.

App Upload

Tool	Description
upload_app	Upload an app binary (IPA/APK/AAB) to DeployGate.

Parameters:

• owner_name (required): Owner name (user or project)
• file_path (required): Absolute path to the app binary
• message: Build description (max 32,766 bytes; auto-truncated if exceeded)
• distribution_key: Distribution page key to update. Takes priority over distribution_name.
• distribution_name: Distribution page name. Creates a new page if not found. Ignored if distribution_key is also specified.
• release_note: Release note for the distribution page
• disable_notify: Disable push notification to testers (iOS only)
• ios_simulator_zip: Path to iOS simulator build zip for Instant Device (browser-based preview). Must be uploaded together with an IPA.

Distribution Page Management

Tool	Description
create_distribution	Create a new distribution page. Returns access_key for the URL https://deploygate.com/distributions/{access_key}
list_distributions	List all distribution pages for an app
get_distribution	Get details of a specific distribution page
update_distribution	Update a distribution page. active and release_scope are always required — use get_distribution first to retrieve current values.
delete_distribution	Delete a distribution page. Uploaded builds (binaries) are preserved.