> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App Co-founder Agent

> An agentic cofounder that analyzes your App Store performance every day, surfaces what matters, and proposes actions you can ship the same morning.

The **App Co-founder Agent** is an agentic cofounder that analyzes your app's performance (App Store, with Google Play support for tracked Android apps), learns from past decisions, and writes you a morning briefing — like a real cofounder who reviewed all the data while you slept.

It runs in your existing Appeeky infrastructure, talks to App Store Connect on your behalf (read-only by default), and can deliver its insights to Slack, Telegram, Linear, GitHub, Notion, your own webhook, or an opt-in public diary.

```
collector → reasoner → actor

every run, in your voice, in your language
```

## Get started

* **[Quickstart](./quickstart)** — 5 minutes from zero to your first briefing
* **[How it works](./concepts/how-it-works)** — the pipeline under the hood

***

## What it does in one sentence

Every morning (or on your cadence), the agent **collects** every available signal about your app, **reasons** about what changed and why, and **acts** by writing a briefing and proposing concrete next steps — optionally executing them with your approval.

```
┌──────────┐    ┌──────────┐    ┌────────┐
│ Collector │ →  │ Reasoner │ →  │ Actor  │
└──────────┘    └──────────┘    └────────┘
   data            insights        delivery
```

***

## What it sees today

| Signal                                | Source            | Notes                                           |
| ------------------------------------- | ----------------- | ----------------------------------------------- |
| ASO health & opportunities            | Appeeky API       | Refreshes weekly to save calls                  |
| Keyword rank changes                  | Appeeky API       | ±5 rank threshold, 7-day window                 |
| Tracked keywords (your list)          | Web app           | Volume, difficulty, current rank, history       |
| Downloads / revenue / subs            | App Store Connect | Direct from your synced metrics                 |
| Impressions / page views / conversion | App Store Connect | "Unique" semantics — matches the ASC dashboard  |
| User reviews + response status        | App Store Connect | Territory, version, unanswered count            |
| Tracked competitors                   | Web app           | Snapshotted daily to detect moves               |
| Market chart movers                   | Appeeky API       | Top free chart trajectory                       |
| Subscription metrics (MRR, trials)    | App Store Connect | When IAP/subscription sync is enabled           |
| Apple Search Ads spend & CPI          | Apple Search Ads  | When connected — includes wasteful search terms |
| Cross-platform revenue                | RevenueCat        | When connected — MRR, actives, trials           |
| Metric forecasts                      | Built-in          | Holt-Winters projections on downloads/revenue   |
| Anomaly & forecast-breach signals     | Built-in          | Can trigger runs outside the schedule           |
| Past actions + outcomes               | Memory            | Decision log with measured impact               |

***

## What it produces

Every run writes a structured `DailyReport` saved in `cofounder_reports`, plus a human-voice **briefing** designed for Slack/email:

```
:wave: Morning Erencan arica! Here's where we stand with Phosum today:

📊 This period
- Downloads: 13 (+13%)
- Revenue: $0 (-100%)
- Impressions: 3,828
- Conversion: 0%
- ASO Score: 38/100 (Grade D)

🔥 What's on fire
- Conversion is at 0%. We had 3,828 impressions and not a single page view.
- Mexico is driving 25% of downloads with no localization — huge ROI miss.

🎯 Today's focus
1. Metadata overhaul (~1h): rewrite subtitle + first screenshot
2. Localize for MX, IT, GB (~2h): top 3 unlocalized markets
3. Track new keywords (~30 min): "screenshot stitching", "pink possum"

💡 One insight
We're getting real Mexico traffic without localization. Translating could
lift downloads from that storefront alone.
```

***

## What's special

1. **Memory** — the agent remembers what worked for *your* app and stops re-proposing things you ignored.
2. **Knowledge Base** — profiles, `business_context.md`, and a markdown Library you edit; the agent reads it on every briefing and can only *propose* changes. See [Knowledge Base](./concepts/knowledge-base).
3. **Stale-action follow-ups** — if you ignored a critical recommendation 5 days ago, the agent will say so directly.
4. **Personality presets** — pick a voice that resonates: *blunt advisor*, *friendly mentor*, *indie hacker*, *PG analytical*, *YC partner*, or *balanced*.
5. **Multi-language briefings** — Turkish, English, German, Spanish, French, Portuguese, Japanese.
6. **Competitor move detection** — snapshots competitors daily; flags subtitle/keyword/version/pricing changes.
7. **Crisis mode** — detects review sentiment cliffs (1-star spikes vs your 30-day baseline) and elevates them above the briefing.
8. **A/B test memory** — when you change your metadata, the agent automatically measures the 14-day before/after impact.
9. **Pricing intelligence** — compares your IAP/sub price against tracked competitors with percentile ranking.
10. **Localization ROI** — surfaces countries where you're getting downloads without local metadata.
11. **Public Founder Diary** — opt-in: share a sanitized briefing publicly via `/cofounder/diary/<your-slug>`.
12. **Why-agent (RCA)** — "why did revenue drop?" gets ranked candidate causes with evidence, not a shrug.
13. **Autopilot scorecard** — aggregated outcomes of applied actions, so you can grant autonomy based on data.
14. **Weekly portfolio briefing** — multi-app owners get one cross-app briefing: where to spend the week.
15. **Bring your own model** — OpenAI, Anthropic, Google, Kimi, or DeepSeek, optionally on your own API key.

***

## Capabilities

| Capability                                                                       | What it does                                                                                                                                 |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [ASO Intelligence](./capabilities/aso-intelligence)                              | Weekly-refreshed ASO score, opportunities, storefront readiness                                                                              |
| [Keyword Tracking](./capabilities/keyword-tracking)                              | Movers (±5 rank delta) + your tracked keyword list with rank history                                                                         |
| [Reviews & Crisis Mode](./capabilities/reviews-crisis-mode)                      | Sentiment cliff detector (1★ spike vs 30d baseline)                                                                                          |
| [Competitor Move Detector](./capabilities/competitor-moves)                      | Daily snapshots → diff for subtitle/keywords/version/pricing changes                                                                         |
| [A/B Test Memory](./capabilities/ab-test-memory)                                 | Detects metadata changes, schedules 14-day follow-up to measure impact                                                                       |
| [Pricing Intelligence](./capabilities/pricing-intelligence)                      | iTunes pricing comparison vs competitors with percentile ranking                                                                             |
| [Monetization Experiments (RevenueCat)](./capabilities/monetization-experiments) | Reads RevenueCat offerings & experiments, opens pricing hypotheses, and promotes a winning offering (always gated)                           |
| [Localization ROI](./capabilities/localization-roi)                              | Surfaces countries getting downloads without metadata localization                                                                           |
| [Goals & OKRs](./capabilities/goals-okr)                                         | North-star targets — the agent prioritizes toward them, tracks pace, and pings you when one drifts off track                                 |
| [Unit Economics & Runway](./capabilities/unit-economics)                         | CAC, LTV, LTV:CAC, payback, burn, and runway — computed from your spend + subscriptions + costs, with runway/payback guardrail alerts        |
| [Retention & Lifecycle](./capabilities/retention-lifecycle)                      | Churn / resubscribe / churn-split lens, churn-spike crisis mode, and gated winback campaigns                                                 |
| [Continuity & Accountability](./capabilities/continuity-accountability)          | Remembers yesterday's briefing, holds you to what you promised, and stops re-pitching ideas you keep declining                               |
| [Decision Log](./capabilities/decision-log)                                      | Browse what the agent recommended → what you did → what happened                                                                             |
| [Second Brain](./capabilities/second-brain)                                      | Ingest outside knowledge (articles, notes, Notion), then audit whether your playbook still holds — and it re-checks itself when metrics move |
| [Multi-language Briefings](./capabilities/multi-language)                        | English, Turkish, Spanish, German, French, Portuguese, Japanese                                                                              |
| [Chat (Ask)](./capabilities/ask-cofounder)                                       | Full conversation with live data tools, memory, and action approvals — web, Slack, Telegram, API                                             |
| [Why-agent (RCA)](./capabilities/why-agent)                                      | "Why did this metric move?" → ranked candidate causes with evidence                                                                          |
| [Autopilot Scorecard](./capabilities/autopilot-scorecard)                        | Aggregated outcomes of applied actions — did they work?                                                                                      |
| [Weekly Portfolio Briefing](./capabilities/portfolio-briefing)                   | One cross-app briefing for multi-app owners                                                                                                  |
| [Public Founder Diary](./capabilities/public-diary)                              | Opt-in: share sanitized briefings via a public URL                                                                                           |
| [Growth Channels (Reddit)](./capabilities/growth-channels)                       | Scan Reddit for high-intent posts about your app, score buying intent with AI, draft replies you approve before posting                      |
| [My Apps workspace](./capabilities/my-apps-workspace)                            | Dashboard parity in chat & runs — localizations, releases, competitors, reports, Google Play analytics; ASC fail → draft fallback            |

***

## Who it's for

* **Indie developers** who want a daily second brain that costs on the order of a cent per run with default models.
* **Small teams** who want their app intelligence delivered to the channels they already use (Slack, Linear, Notion).
* **Power users** who want a webhook firehose to plug the agent into their own systems.

***

## Quick links

* [Quickstart](./quickstart) — 5 minutes from zero to your first briefing
* [How it works](./concepts/how-it-works) — collector → reasoner → actor pipeline
* [Knowledge Base](./concepts/knowledge-base) — profiles, Library, patches, and the API behind them
* [Integrations](./integrations/slack) — wire up Slack, Linear, GitHub, Notion, Webhook
* [API reference](./api/preferences) — agent runtime, planning, analysis
