Document Superwall AI, the assistant in the dashboard, docs, and superwall.com

content/docs/dashboard/guides/superwall-mcp.mdx

@@ -6,7 +6,7 @@ description: "Manage Superwall projects, paywalls, campaigns, products, and more
 The Superwall MCP lets AI agents manage your Superwall account through the [Model Context Protocol](https://modelcontextprotocol.io). Instead of clicking through the dashboard, you can create projects, paywalls, campaigns, products, and more directly from tools like Claude Code, Cursor, and Codex.
 
 <Note>
-This is different from [Superwall Agents](/agents), which is the <mark className="bg-yellow-200 text-yellow-950">Superwall Agents workspace</mark> for chats, analysis, automations, webhooks, and hosted machine work. The Superwall MCP is focused on giving external AI tools access to your Superwall account to create and manage resources. If you also want live docs and SDK integration guidance, use the [Superwall Skill](/dashboard/guides/superwall-skill).
+This is different from [Superwall Agents](/agents), which is the Superwall Agents workspace for chats, analysis, automations, webhooks, and hosted machine work. The Superwall MCP is focused on giving external AI tools access to your Superwall account to create and manage resources. If you also want live docs and SDK integration guidance, use the [Superwall Skill](/dashboard/guides/superwall-skill).
 </Note>
 
 <Tip>

content/docs/dashboard/guides/superwall-skill.mdx

@@ -6,7 +6,7 @@ description: "Give AI coding agents up-to-date Superwall docs, authenticated API
 The [Superwall Skills](https://github.com/superwall/skills) are a set of [Agent Skills](https://agentskills.io) that give AI coding agents everything they need to work with Superwall: live documentation, authenticated access to your account through the [Superwall CLI](/dashboard/guides/superwall-cli), guided SDK integration flows for every platform, and hands-on control of the paywall editor.
 
 <Note>
-This is different from [Superwall Agents](/agents), which is the <mark className="bg-yellow-200 text-yellow-950">Superwall Agents workspace</mark> for chats, analysis, automations, webhooks, and hosted machine work. The Superwall Skill is for giving AI coding agents Superwall docs, API access, and SDK guidance. The Skill can perform all of the tasks the [Superwall MCP](/dashboard/guides/superwall-mcp) can, and is recommended when you are working in an external coding agent.
+This is different from [Superwall Agents](/agents), which is the Superwall Agents workspace for chats, analysis, automations, webhooks, and hosted machine work. The Superwall Skill is for giving AI coding agents Superwall docs, API access, and SDK guidance. The Skill can perform all of the tasks the [Superwall MCP](/dashboard/guides/superwall-mcp) can, and is recommended when you are working in an external coding agent.
 </Note>
 
 ## Installation

content/docs/dashboard/superwall-ai.mdx

@@ -3,12 +3,12 @@ title: "Superwall AI"
 description: "Ask questions about Superwall, your account, and your data with Superwall AI, the assistant built into the dashboard, the docs, and superwall.com."
 ---
 
-<div className="rounded-md border border-yellow-300 bg-yellow-100 px-4 py-3 text-yellow-950 [&_a]:!text-yellow-900 [&_a]:!decoration-yellow-700 [&_a:hover]:!text-yellow-950 [&_code]:!bg-yellow-950 [&_code]:!text-yellow-50 [&_li::marker]:!text-yellow-700 [&_strong]:!text-yellow-950 [&_table]:!text-yellow-950 [&_td]:!text-yellow-950 [&_th]:!text-yellow-950">
+Superwall AI is the assistant built into the dashboard. Ask it how anything in Superwall works, what's in your account, or what your data says, and it goes and finds out: it reads the docs, checks SDK source code, calls the Superwall API for your organization, and runs analytics queries, then answers with links so you can keep exploring.
 
-Superwall AI is the assistant built into the dashboard. Ask it how anything in Superwall works, what's in your account, or what your data says, and it goes and finds out: it reads the docs, checks SDK source code, calls the Superwall API for your organization, and runs analytics queries, then answers with links so you can keep exploring. It's a conversation, so follow up and go deeper.
+It's also useful for more than troubleshooting: ask how a paywall is performing or where conversion dropped, and it will pull the data, chart it, and point out what stands out.
 
 <Note>
-This is different from [Superwall Agents](/agents), the separate AI workspace at superwall.ai for hosted machines, automations, files, and webhook-driven work. Superwall AI is the built-in assistant: no setup, right where you're already working.
+Superwall AI is eventually replacing [Superwall Agents](/agents). This is built-in, with no setup or limits, and it's automatically aware of your context.
 </Note>
 
 ## Opening it
@@ -23,23 +23,31 @@ The assistant opens in a panel docked to the right, pushing the dashboard aside
 
 ## What you can ask
 
-- **How Superwall works**: concepts, setup, best practices, and SDK behavior. Answers are grounded in the live docs and the SDK source code, and include links to the pages it used.
-- **Your account**: projects, apps, campaigns, paywalls, products, and entitlements. The assistant reads them through the Superwall API, scoped to your organization.
-- **Your data**: plain-English analytics questions. It writes and runs queries against your organization's analytics data, the same data behind [Query ClickHouse](/dashboard/guides/query-clickhouse). The suggested prompts in the panel are good starting points: ARPU by user attributes, cancellation timing, converters versus non-converters.
+- **How Superwall works**: Concepts, setup, best practices, and SDK behavior. Answers are grounded in the live docs and the SDK source code, and include links to the pages it used.
+- **Your account**: Projects, apps, campaigns, paywalls, products, and entitlements. The assistant reads them through the Superwall API, scoped to your organization.
+- **Your data**: Plain-English analytics questions. It writes and runs queries against your organization's analytics data, the same data behind [Query ClickHouse](/dashboard/guides/query-clickhouse). The suggested prompts in the panel are good starting points: ARPU by user attributes, cancellation timing, converters versus non-converters.
 
 It can also link you directly to the right dashboard page, and search the web when a question needs outside information.
 
 ## Page context
 
-The chip above the composer shows the page you're currently viewing, like **Paywalls & Flows**. The assistant uses it to tailor answers to where you are, so "why is this empty?" means something. Remove the chip with its ✕ when you want a question answered without that context.
+The chip above the composer shows the page you're currently viewing:
+
+<Frame>![The Superwall AI panel on the Quickstart page, with the page-context chip reading Quickstart.](/images/ai_dash_context_aware_url_1.jpg)</Frame>
+
+Move somewhere else, like Products & Entitlements, and notice the chip updates on its own. The assistant is always looking at what you're looking at:
+
+<Frame>![After navigating to Products & Entitlements, the page-context chip now reads Products.](/images/ai_dash_context_aware_url_2.jpg)</Frame>
+
+It uses that context to tailor answers to where you are, so "why is this empty?" means something. Remove the chip with its ✕ when you want a question answered without it. On the docs site it goes a step further and reads the content of the page you're viewing, so you can ask directly about whatever is on screen.
 
 ## Choosing a model
 
 The composer's model picker switches the underlying AI model: Sonnet is the default, with Opus, GPT, Grok, and Kimi available, plus a reasoning-effort setting for harder questions. Superwall keeps each option pointed at the latest version of that model family automatically.
 
 ## Chats
 
-Conversations persist: reopen the panel and your last chat is right where you left it. The list icon in the top bar shows your chat history, and the pencil starts a fresh chat. Chats are private to your user account; teammates in your organization can't see them.
+Conversations persist: reopen the panel and your last chat is right where you left it. The list icon in the top bar shows your chat history, and the pencil starts a fresh chat. Chats are private to you and stored per browser: teammates never see them, and a different browser or device starts with a fresh history.
 
 ## On the docs site and superwall.com
 
@@ -52,5 +60,3 @@ The same assistant is available outside the dashboard: the floating bubble in th
 - [Superwall Skill](/dashboard/guides/superwall-skill): Give external coding agents the same Superwall knowledge.
 - [Superwall MCP](/dashboard/guides/superwall-mcp): Manage your account from MCP-compatible AI tools.
 - [Vibe Coding](/sdk/guides/vibe-coding): All the AI tools for working with Superwall in one place.
-
-</div>

content/shared/vibe-coding.mdx

@@ -7,23 +7,21 @@ description: "How to Vibe Code using the knowledge of the Superwall Docs"
 
 We've built a few tools to help you Vibe Code using the knowledge of the Superwall Docs, access your Superwall account, and more right in your favorite AI tools:
 
-- [Superwall Agents](#superwall-agents): An AI workspace for analyzing Superwall data exposed by connected tooling, reviewing experiments, working with available files, scheduling recurring reports, and connecting webhooks.
+- [Superwall AI](#superwall-ai): The assistant built into the dashboard, these docs, and superwall.com. Ask about Superwall, your account, or your data, with nothing to set up. Start here.
+- [Superwall Agents](/agents): An AI workspace for analyzing Superwall data exposed by connected tooling, reviewing experiments, working with available files, scheduling recurring reports, and connecting webhooks.
 - [Superwall Skill (Recommended for coding agents)](#superwall-skill-recommended-for-coding-agents): Gives AI agents live docs, API access, and step-by-step SDK integration guides. If you are working in an external coding agent, pick this one.
 - [Superwall CLI](#superwall-cli): Set up the SDK, manage your account, and query analytics from the terminal. Also the fastest way to integrate: `npx superwall integrate`.
 - [Superwall MCP](#superwall-mcp): Expose your Superwall account (projects, paywalls, campaigns) to work with AI tools.
 - [Editor AI](#editor-ai): Build and refine a paywall directly inside the visual editor using AI Chat or an external MCP-compatible agent.
 
 And right here in the Superwall Docs:
 
-- [Superwall AI](#superwall-ai)
 - [Docs Links](#docs-links)
 - [LLMs.txt](#llmstxt)
 
-## Superwall Agents
-
-[Superwall Agents](/agents) is <mark className="bg-yellow-200 text-yellow-950">the dedicated agent workspace at superwall.ai</mark>. Use it when you want to analyze experiment results, use selected Superwall organization context, work with files available to the active hosted machine, create charts and reports, suggest new experiments, schedule recurring prompts, or connect webhook-driven workflows.
+## Superwall AI
 
-Use it from [superwall.ai](https://superwall.ai). Superwall Agents works with a hosted machine tied to your account, so you can run chats, Files, Terminal, automations, and webhook-driven work from the same Superwall workspace. Start with the [Superwall Agents docs](/agents).
+[Superwall AI](/dashboard/superwall-ai) is the assistant in the bottom right 💬 of these docs, superwall.com, and the dashboard, and behind the **Ask AI** button in the docs search. It's an agent: it reads the docs and SDK source before answering, links what it used, and holds a conversation so you can follow up. In the dashboard it can also work with your account and analytics data. See the [Superwall AI guide](/dashboard/superwall-ai).
 
 ## Superwall Skill (Recommended for Coding Agents)
 
@@ -64,14 +62,6 @@ The paywall editor has AI tools for working on the paywall currently open in you
 
 Use Editor AI when the task is about changing the design, layout, products, variables, tap behaviors, navigation, or localization of the current paywall. Use the account-level [Superwall MCP](/dashboard/guides/superwall-mcp) when the task is about creating or managing dashboard resources such as projects, applications, campaigns, products, entitlements, or webhooks.
 
-## Superwall AI
-
-<div className="rounded-md border border-yellow-300 bg-yellow-100 px-4 py-3 text-yellow-950 [&_a]:!text-yellow-900 [&_a]:!decoration-yellow-700 [&_a:hover]:!text-yellow-950 [&_code]:!bg-yellow-950 [&_code]:!text-yellow-50 [&_li::marker]:!text-yellow-700 [&_strong]:!text-yellow-950 [&_table]:!text-yellow-950 [&_td]:!text-yellow-950 [&_th]:!text-yellow-950">
-
-[Superwall AI](/dashboard/superwall-ai) is the assistant in the bottom right 💬 of these docs, superwall.com, and the dashboard, and behind the **Ask AI** button in the docs search. It's an agent: it reads the docs and SDK source before answering, links what it used, and holds a conversation so you can follow up. In the dashboard it can also work with your account and analytics data. See the [Superwall AI guide](/dashboard/superwall-ai).
-
-</div>
-
 ## Docs Links
 
 At the top of each page of the Superwall Docs (including this one!):