Title99/100
Plan a mobile app
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Plan turning an existing web app, a live website or a new idea into a Capacitor iOS and Android app, end to end. Start here for any "make my website or web app a mobile app" request. The hosted server cannot read files: first inspect the project yourself (package.json dependencies, devDependencies and lockfile, capacitor.config, ios/ and android/ folders, node --version, xcodebuild -version) and pass what you found. Returns ordered phases (prepare, static build or scaffold, Capacitor on the latest npm release, mobile design, native plugins, run, Capgo live updates and cloud builds, store submission). Each step has commands, file changes, verify checks, who runs it, the Capgo tools to call and the capgo-skills skill to load. Also returns plugin picks, run options (local simulator or emulator, physical device, Capgo app preview, Capgo cloud simulator), warnings and the next tool. Confirm the app name and app ID with the user before npx cap init. Read-only: it changes nothing.
The description explains the capability, when to use it, and what to expect.
Inputs97/100
Input documentation gives an agent enough context to populate the arguments.
source
Starting point, which decides the first phases: migrating a web app whose source code you can read, a live website known only by its URL (the plan warns that its source code or a static export is needed), or a new app with no code yet (the plan scaffolds a Vite app).
Clear enough to supply this argument.
packages
Installed packages from package.json, with dependencies and devDependencies merged into one name-to-version-range object such as {"next":"^15.2.0","@capacitor/core":"^8.4.0"}. The plan detects the framework and the installed Capacitor version from it, and leaves out installs for packages already listed. Omit when the project has no package.json.
Clear enough to supply this argument.
framework
Web framework of the project, which sets the static build command and the folder Capacitor packages. Omit to detect it from packages; set it only when detection is wrong or there is no package.json. A value that differs from the packages wins, with a warning.
Clear enough to supply this argument.
template
new_app only: Vite template for the scaffold. Default react.
Clear enough to supply this argument.
projectName
new_app only: folder name for the new project. Defaults to the app name.
Clear enough to supply this argument.
appName
Name shown under the app icon. Ask the user; defaults from the website domain.
Clear enough to supply this argument.
appId
Reverse-domain app ID the user owns, e.g. com.acme.shop. It becomes the iOS bundle identifier and Android applicationId and is permanent once published. Omit to get a suggestion.
Clear enough to supply this argument.
websiteUrl
Public URL of the website, used to suggest the app name and app ID. Required context for source website_only.
Clear enough to supply this argument.
platforms
Platforms to publish on. The plan adds only these native projects, run options and store steps. Omit to plan for every supported platform.
Clear enough to supply this argument.
features
Native features the app needs, from the user's goals and the audit. Each one adds a plugin recommendation; live_updates is always added.
Clear enough to supply this argument.
traits
Product traits that turn on store rules: accounts (users sign up or log in), third_party_login (Google/Facebook/...), digital_goods (subscriptions, credits, premium features), physical_goods, user_generated_content, kids, health_data, location, push, ads_or_tracking, ai_features (user data sent to an AI service), personal_play_account (Google Play personal developer account created after 2023-11-13).
Clear enough to supply this argument.
packageManager
Package manager of the project, from its lockfile. Commands use it for installs; Capacitor and Capgo commands stay npx. Default npm.
Clear enough to supply this argument.
environment › shell
true when you can run commands in the user's project. false (for example a web chat or app builder without a terminal) switches the plan to a handoff.
Clear enough to supply this argument.
environment › os
Operating system of the machine that runs the commands. iOS simulators and local iOS builds need macos.
Clear enough to supply this argument.
environment › xcode
Result of xcodebuild -version: true when Xcode is installed.
Clear enough to supply this argument.
environment › androidSdk
true when the Android SDK and an emulator image are installed (ANDROID_HOME set, or Android Studio present).
Clear enough to supply this argument.
environment › nodeVersion
Output of node --version, e.g. v22.12.0.
Clear enough to supply this argument.
existing › capacitorConfig
capacitor.config.ts or capacitor.config.json already exists.
Clear enough to supply this argument.
existing › ios
The ios/ native project already exists.
Clear enough to supply this argument.
existing › android
The android/ native project already exists.
Clear enough to supply this argument.
existing › capgoApp
The app is already registered in Capgo (capgo_get_app succeeds).
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Plan a mobile app",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema95/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"summary",
"mode",
"source",
"framework",
"capacitor",
"app",
"platforms",
"warnings",
"phases",
"plugins",
"run_options",
"checklist",
"skills",
"next_tool"
],
"properties": {
"app": {
"type": "object",
"required": [
"name",
"app_id",
"app_id_source"
],
"properties": {
"name": {
"type": "string",
"description": "App name to use with npx cap init."
},
"app_id": {
"type": "string",
"description": "App ID to use with npx cap init; confirm with the user first."
},
"app_id_source": {
"enum": [
"input",
"website",
"placeholder"
],
"type": "string",
"description": "input: given by the caller. website: derived from websiteUrl. placeholder: must be replaced by the user's own reverse domain."
}
},
"description": "App identity.",
"additionalProperties": false
},
"mode": {
"enum": [
"run_commands",
"handoff"
],
"type": "string",
"description": "run_commands: execute the agent steps. handoff: you cannot run commands here; write the changes and a handoff document for the user or CI."
},
"phases": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"goal",
"steps"
],
"properties": {
"id": {
"type": "string",
"description": "Phase id: prepare, scaffold or static_build, capacitor, native_ux, native_features, run, capgo, store."
},
"goal": {
"type": "string",
"description": "What is true when the phase is done."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"detail",
"commands",
"files",
"verify",
"mcp_tools",
"skill",
"checklist_ids",
"run_by"
],
"properties": {
"id": {
"type": "string",
"description": "Stable step id within the phase."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"change"
],
"properties": {
"path": {
"type": "string",
"description": "File to create or edit."
},
"change": {
"type": "string",
"description": "Content to add or the change to make."
}
},
"additionalProperties": false
},
"description": "File changes for this step."
},
"skill": {
"type": [
"string",
"null"
],
"description": "Capgo skill with the full procedure (install with npx skills add Cap-go/capgo-skills), or null."
},
"title": {
"type": "string",
"description": "What this step achieves."
},
"detail": {
"type": "string",
"description": "Instructions and context for the step."
},
"run_by": {
"enum": [
"agent",
"user"
],
"type": "string",
"description": "agent: run it yourself. user: needs the user (a decision, an interactive command, store accounts or signing secrets)."
},
"verify": {
"type": "array",
"items": {
"type": "string"
},
"description": "How to confirm the step worked before moving on."
},
"commands": {
"type": "array",
"items": {
"type": "string"
},
"description": "Shell commands to run in order from the project folder. Empty when the step is a code change or a decision."
},
"mcp_tools": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capgo MCP tools to call in this step."
},
"checklist_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Checklist rules this step satisfies."
}
},
"additionalProperties": false
},
"description": "Ordered steps."
},
"title": {
"type": "string",
"description": "Phase name."
}
},
"additionalProperties": false
},
"description": "Ordered phases; finish each phase's verify checks before the next."
},
"skills": {
"type": "object",
"required": [
"install_command",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url",
"use_for"
],
"properties": {
"url": {
"type": "string",
"description": "GitHub folder of the skill; its SKILL.md has the full procedure."
},
"name": {
"type": "string",
"description": "Skill name in Cap-go/capgo-skills."
},
"use_for": {
"type": "string",
"description": "When to load this skill."
}
},
"additionalProperties": false
},
"description": "Skills used by this plan."
},
"install_command": {
"type": "string",
"description": "Command that installs every Capgo skill into the agent."
}
},
"description": "Capgo skills with the detailed procedures.",
"additionalProperties": false
},
"source": {
"enum": [
"existing_web_app",
"website_only",
"new_app"
],
"type": "string",
"description": "Starting point of the plan."
},
"plugins": {
"type": "array",
"items": {
"type": "object",
"required": [
"feature",
"package",
"publisher",
"purpose",
"install",
"docs_url",
"ios",
"android",
"notes",
"store_notes",
"checklist_ids",
"skill",
"alternatives"
],
"properties": {
"ios": {
"type": "object",
"required": [
"usage_keys",
"capabilities"
],
"properties": {
"usage_keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "Info.plist NS...UsageDescription keys the plugin can trigger; \"A or B\" means either key."
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Xcode Signing & Capabilities entries to enable."
}
},
"description": "iOS configuration the plugin needs.",
"additionalProperties": false
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Setup notes and traps."
},
"skill": {
"type": [
"string",
"null"
],
"description": "Capgo skill with the full procedure (install with npx skills add Cap-go/capgo-skills), or null."
},
"android": {
"type": "object",
"required": [
"permissions"
],
"properties": {
"permissions": {
"type": "array",
"items": {
"type": "string"
},
"description": "AndroidManifest.xml permissions and runtime prompts to expect."
}
},
"description": "Android configuration the plugin needs.",
"additionalProperties": false
},
"feature": {
"type": "string",
"description": "Feature this plugin serves, or baseline for plugins every app needs."
},
"install": {
"type": "string",
"description": "Install command for the project's package manager. Run npx cap sync afterwards."
},
"package": {
"type": "string",
"description": "Exact npm package name."
},
"purpose": {
"type": "string",
"description": "What the plugin does for this app."
},
"docs_url": {
"type": "string",
"description": "Plugin documentation."
},
"publisher": {
"enum": [
"capacitor",
"capgo"
],
"type": "string",
"description": "capacitor: official @capacitor plugin. capgo: Capgo-maintained @capgo plugin."
},
"store_notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Store review rules that apply when using this plugin."
},
"alternatives": {
"type": "array",
"items": {
"type": "string"
},
"description": "Other packages that cover the same need and when to prefer them."
},
"checklist_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Related ids from capgo_get_mobile_checklist."
}
},
"additionalProperties": false
},
"description": "Plugin recommendations for the requested features, live updates and the baseline."
},
"summary": {
"type": "string",
"description": "One-line summary of the plan."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
},
"description": "Risks, blockers and assumptions to tell the user about before starting."
},
"capacitor": {
"type": "object",
"required": [
"latest_version",
"next_version",
"version_source",
"installed_version",
"action",
"node_requirement"
],
"properties": {
"action": {
"enum": [
"install",
"upgrade",
"keep"
],
"type": "string",
"description": "What to do with Capacitor in this project."
},
"next_version": {
"type": [
"string",
"null"
],
"description": "Pre-release on the npm next tag; do not use it for production."
},
"latest_version": {
"type": "string",
"description": "Latest stable @capacitor/core on npm."
},
"version_source": {
"enum": [
"npm",
"fallback"
],
"type": "string",
"description": "npm: read live from the registry. fallback: last known version because npm did not answer."
},
"node_requirement": {
"type": "string",
"description": "Node.js version range Capacitor needs."
},
"installed_version": {
"type": [
"string",
"null"
],
"description": "@capacitor/core range from packages, or null."
}
},
"description": "Capacitor version decision.",
"additionalProperties": false
},
"checklist": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"severity",
"title"
],
"properties": {
"id": {
"type": "string",
"description": "Checklist rule id; read the full rule with capgo_get_mobile_checklist."
},
"title": {
"type": "string",
"description": "Short rule name."
},
"severity": {
"enum": [
"blocker",
"required",
"recommended"
],
"type": "string",
"description": "Rule severity."
}
},
"additionalProperties": false
},
"description": "Design and native rules to apply while building. Store rules come from capgo_get_mobile_checklist."
},
"framework": {
"type": "object",
"required": [
"id",
"name",
"detected_from",
"web_dir",
"build_command",
"static_export_required",
"server_features_to_check"
],
"properties": {
"id": {
"enum": [
"nextjs",
"nuxt",
"sveltekit",
"angular",
"react_router",
"remix",
"astro",
"solidstart",
"qwik",
"gatsby",
"create_react_app",
"vue_cli",
"vite",
"static_html",
"unknown"
],
"type": "string",
"description": "Framework the plan targets."
},
"name": {
"type": "string",
"description": "Framework display name."
},
"web_dir": {
"type": "string",
"description": "Static build output folder to use as webDir (replace <project> placeholders)."
},
"build_command": {
"type": [
"string",
"null"
],
"description": "Command that builds the web assets, or null when there is no build step."
},
"detected_from": {
"enum": [
"packages",
"input",
"template",
"none"
],
"type": "string",
"description": "How the framework was chosen."
},
"static_export_required": {
"type": "boolean",
"description": "The framework needs configuration changes before it emits a static index.html."
},
"server_features_to_check": {
"type": "array",
"items": {
"type": "string"
},
"description": "Server-only features to search for and move to a hosted API."
}
},
"description": "Web framework and its static build settings.",
"additionalProperties": false
},
"next_tool": {
"type": "object",
"required": [
"name",
"reason"
],
"properties": {
"name": {
"type": "string",
"description": "Capgo MCP tool to call next."
},
"reason": {
"type": "string",
"description": "Why to call it now."
}
},
"description": "Suggested next tool call.",
"additionalProperties": false
},
"platforms": {
"type": "array",
"items": {
"enum": [
"ios",
"android"
],
"type": "string"
},
"description": "Platforms this entry applies to."
},
"run_options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"platforms",
"available",
"requirements",
"steps",
"mcp_tools",
"cost"
],
"properties": {
"id": {
"enum": [
"ios_simulator",
"android_emulator",
"physical_device",
"capgo_preview_app",
"capgo_cloud_simulator"
],
"type": "string",
"description": "Run target."
},
"cost": {
"type": "string",
"description": "Cost or quota used."
},
"steps": {
"type": "array",
"items": {
"type": "string"
},
"description": "How to start the app on it."
},
"title": {
"type": "string",
"description": "Run target name."
},
"available": {
"enum": [
"yes",
"no",
"unknown"
],
"type": "string",
"description": "Whether it works with the reported environment; unknown when not checked."
},
"mcp_tools": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capgo MCP tools involved."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"ios",
"android"
],
"type": "string"
},
"description": "Platforms this entry applies to."
},
"requirements": {
"type": "array",
"items": {
"type": "string"
},
"description": "What it needs."
}
},
"additionalProperties": false
},
"description": "Ways to run the app, local and Capgo cloud."
}
},
"additionalProperties": false
}