diff --git a/distribution/play-store-listing.md b/distribution/play-store-listing.md new file mode 100644 index 0000000..26c164e --- /dev/null +++ b/distribution/play-store-listing.md @@ -0,0 +1,177 @@ +# Play Store ASO Listing — OpenCode Mobile + +**Package:** cc.agentlabs.opencode +**Generated:** 2026-06-20 +**Based on:** app v0.4+, ASO audit findings from aso-audit.md + +--- + +## 1. App Title (max 50 chars) + +``` +OpenCode: AI Coding Agent for Developers +``` +(41/50 chars) + +**Rationale:** Leads with the brand name, immediately followed by the two highest-value keywords ("AI Coding Agent") and an audience qualifier ("for Developers"). The 50-char Google Play title field (larger than the 30-char limit that applies when the field is shared with subtitle) lets us pack in more signal than the older 30-char title. If the console enforces 30 chars, fall back to: + +``` +OpenCode: AI Coding Agent +``` +(25/30 chars — primary option from aso-audit.md) + +--- + +## 2. Short Description (max 80 chars) + +``` +AI coding agent in your pocket. Stream, diff, approve — free & open source. +``` +(76/80 chars) + +**Rationale:** Opens with the primary keyword phrase. The three action verbs ("Stream, diff, approve") map directly to the three headline features without requiring "Read More." "Free & open source" is a strong conversion signal for developer audiences. Avoids the word "free" as the very first word (Play policy) by placing it after the keyword. + +--- + +## 3. Full Description (max 4000 chars) + +``` +OpenCode Mobile is the AI coding agent companion built for developers who self-host opencode. Connect your Android phone to your opencode server and run AI-powered coding sessions from anywhere — watch diffs land, approve tool calls, and guide Claude, GPT-4, or Gemini in real time. + +WHAT IT DOES +OpenCode Mobile is a thin client for the opencode CLI (github.com/sst/opencode). It speaks the opencode HTTP + SSE API, so every AI coding session on your workstation or server is instantly reachable from your phone. All AI model calls go through your own server — your API keys, your code, your infrastructure. Nothing passes through our servers. + +CORE FEATURES +• Real-time streaming chat — watch your AI coding assistant think and respond token by token, just like a desktop terminal +• File diff viewer — see every code change the agent proposes before you approve it; no surprise rewrites +• Tool-call approval — review and approve or reject file writes, shell commands, and other agent actions from your phone +• Multi-session management — start, resume, and switch between AI coding sessions without losing context +• Biometric unlock — fingerprint or face unlock keeps your sessions private on shared or lost devices + +CONNECTION OPTIONS +Connect any way that works for your setup: +• Local Wi-Fi — zero config when phone and dev machine are on the same network +• Tailscale — connect securely across networks without opening ports; ideal for remote work +• Cloudflare Tunnel — public HTTPS endpoint for your opencode server in minutes +• ngrok — quick ad-hoc tunnels for demos or one-off remote sessions +• opencode Cloud — managed hosting coming soon + +WHO IT'S FOR +• Developers running opencode on their workstation who want to check in from their phone +• Engineers away from their desk who want to review or steer long-running AI coding jobs +• Teams self-hosting AI developer tools who want a polished mobile interface +• Open-source contributors who want a free, MIT-licensed alternative to proprietary AI coding apps + +WHAT IT IS NOT +• Not a standalone AI model — you bring your own opencode server (which connects to Claude, GPT-4, Gemini, or local LLMs via your API keys) +• Not a code editor — it pairs with your existing IDE and terminal workflow +• Not a subscription app — free, open-source, MIT licensed, no ads, no telemetry you did not opt into + +GETTING STARTED +Install opencode on any machine: + npm install -g opencode-ai + opencode serve + +Then open the app, tap Connect, paste your server URL, and you're in. Your AI coding agent is now on your phone. + +OPEN SOURCE +OpenCode Mobile is MIT licensed. Source code, issue tracker, and community at github.com/dzianisv/opencode-mobile. Contributions welcome. + +PRIVACY +OpenCode Mobile does not collect your code, prompts, or AI responses. All traffic goes directly from the app to YOUR opencode server — never through our infrastructure. Optional Sentry crash reporting collects only device model, OS version, and stack traces (no message content). + +Support: support@vibebrowser.app +Issues: github.com/dzianisv/opencode-mobile/issues +Source: github.com/dzianisv/opencode-mobile +``` + +(~3050/4000 chars — room to expand with testimonials or changelog highlights as they become available) + +--- + +## 4. Keyword Suggestions + +For Google Play metadata fields and to guide copy iteration. Target ~100 chars per submission slot where applicable. + +``` +AI coding agent, coding assistant, developer tools, opencode, self-hosted AI, code review mobile +``` +(97 chars) + +**Extended keyword list (prioritized):** + +| Keyword | Search intent | Priority | +|---|---|---| +| `AI coding agent` | Primary — maps exactly to what the app is | Critical | +| `coding assistant` | Broad — captures users looking for any AI coding help | Critical | +| `opencode` | Brand — captures existing opencode CLI users | High | +| `developer tools` | Category — broad developer audience | High | +| `self-hosted AI` | Qualifier — filters for our target user (devs who self-host) | High | +| `mobile coding` | Feature — "code from phone" niche | Medium | +| `AI code review` | Feature — maps to diff viewer | Medium | +| `remote development` | Use case — devs working off-device | Medium | +| `LLM client` | Technical — early-adopter / OSS audience | Medium | +| `Claude mobile` | Brand transfer — Anthropic Claude users | Medium | +| `AI terminal` | Technical — CLI-oriented devs | Low | +| `Tailscale developer` | Long-tail — captures Tailscale users looking for dev tools | Low | + +**Keywords to avoid (Play policy):** +- `Copilot`, `Cursor`, `Codeium` — competitor brand names +- `#1 AI coding app`, `best AI developer tool` — superlative claims prohibited +- `free AI` as a standalone phrase — policy sensitive in title/short desc +- `ChatGPT` — OpenAI brand mark + +--- + +## 5. Screenshot Captions (5 screenshots) + +One caption per screenshot, optimized for the Play Store screenshot carousel. Captions appear as overlay text; keep them short and benefit-led. + +### Screenshot 1 — Connection Setup +**Screen to show:** The "Add Connection" / server URL entry screen with connection type options (Wi-Fi, Tailscale, Cloudflare Tunnel, ngrok) visible. + +**Caption:** +``` +Connect to your opencode server — Wi-Fi, Tailscale, or tunnel +``` + +### Screenshot 2 — Live Streaming Chat Session +**Screen to show:** Active chat session with an AI response streaming in, showing partial token-by-token output and a code block mid-render. + +**Caption:** +``` +Watch your AI coding agent think in real time, token by token +``` + +### Screenshot 3 — File Diff Viewer +**Screen to show:** Diff view for a proposed code change with colored additions/removals and an Approve / Reject button visible. + +**Caption:** +``` +Review every file change before it lands — approve or reject +``` + +### Screenshot 4 — Tool-Call Approval Dialog +**Screen to show:** Tool-call approval modal showing a pending shell command or file write with Approve / Reject controls. + +**Caption:** +``` +Stay in control: approve shell commands and file writes from your phone +``` + +### Screenshot 5 — Session List +**Screen to show:** Session list tab showing multiple AI coding sessions with timestamps and status indicators. + +**Caption:** +``` +Manage multiple AI coding sessions — resume any job from anywhere +``` + +--- + +## Notes for Play Console entry + +- Paste the full description using HTML bold tags (`...`) — Play Console renders these as bold section headers. +- Type `&` as a literal ampersand in Play Console forms, not as `&`. +- Screenshot captions are entered per-screenshot in the "Add captions" field of the Graphics section; they are optional but improve accessibility and carousel CVR. +- Keyword list is not a direct Play Console field — use it to guide copy revisions and A/B tests via Play Store Experiments.