AI Agent Overview

Automate an entire App Store and Google Play submission from a single command - what the AI Agent does, what it costs, and when to use it.

Updated 2026-04-21
6 min read

The AI Agent runs your app through an automated launch pipeline. It analyzes your local project, connects to your stores, generates metadata in every language you pick, writes your legal documents, builds a landing page, and pushes everything to App Store Connect and Google Play - all in one orchestrated flow.

What the Agent does

  • Creates a Forvibe project and connects your store credentials
  • Searches and analyzes competitor apps, extracts keywords, does gap analysis
  • Generates ASO-optimized App Store metadata (name, subtitle, description, keywords, promo text, release notes) and localizes to every language you select
  • Declares age rating, categories, privacy data types, pricing
  • Generates Play Store metadata in the different format the Play Store requires (shorter title, 80-char short description, HTML description)
  • Generates a Feature Graphic for Play Store and localizes it per language
  • Writes Privacy Policy, Terms of Use, Disclaimer, and EULA - and pushes the EULA to App Store Connect
  • Builds a full landing page hosted on your Forvibe subdomain
  • Pushes App Review contact details and Play Data Safety declaration

The Agent does not upload your build to the stores - you still do that from Xcode/Android Studio or Fastlane. The Agent handles everything around the build: listings, assets, legal, landing.

How the flow works

You start on the web: open the new project wizard and choose Agent mode, pick your stores, provide credentials, and the dashboard gives you a 6-character one-time code (OTC). You then run the Forvibe CLI in your project directory with an AI API key exported, paste the OTC when prompted, and the CLI analyzes your code locally and uploads an analysis report. Once the CLI connects, you are redirected to /console/agent/[sessionId], where the web UI shows a timeline of phases you trigger one by one.

bash
# 1. Generate an OTC at forvibe.app/console/project/new (choose Agent mode)

# 2. In your app's project directory, export an AI key
export ANTHROPIC_API_KEY=sk-ant-...

# 3. Run the CLI and paste the OTC when prompted
npx @forvibe/cli

The web UI shows a timeline of phases. You trigger each phase by clicking Start; progress streams back in real time over Server-Sent Events. Phases pause for your input at natural review points (competitor selection, metadata review, screenshot upload).

Credit cost

  • App Store automation: 100 credits (bundled, covers all App Store phases)
  • Play Store automation: 50 credits (bundled, covers all Play Store phases)
  • Credits are deducted at the final Review & Confirm phase per store, not per sub-phase
  • If a phase fails mid-run, credits are not charged - retry is free until the store push completes

You need at least 100 credits on your account to start the Agent. Free plan users have 200 starter credits, enough for one App Store automation. See the credits reference for the full cost table.

When to use the Agent vs. manual tools

  • Use the Agent when you are launching a new app or adding a new platform - it is designed for end-to-end setup.
  • Use the individual tools (Store Listings editor, Landing Page editor, Legal generator) when you just need to update one thing on an existing listing.
  • The Agent is idempotent - if you re-run it against the same project, it will not duplicate landing pages or legal docs, it updates in place.

Troubleshooting

  • 402 Payment Required when starting - you do not have enough credits. Top up or upgrade to Pro.
  • OTC expired - codes are valid for 15 minutes. Re-run the CLI to get a fresh code.
  • Session stuck on a phase - close the browser and re-open /console/agent/[sessionId]; the session resumes from the last completed phase.

Next step: see how each phase works in detail, or learn the CLI flow.