diff --git a/content/docs/dashboard/guides/superwall-skill.mdx b/content/docs/dashboard/guides/superwall-skill.mdx
index 9f8ae12..a00c5ac 100644
--- a/content/docs/dashboard/guides/superwall-skill.mdx
+++ b/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.
-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.
+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.
## Installation
diff --git a/content/docs/dashboard/superwall-ai.mdx b/content/docs/dashboard/superwall-ai.mdx
index 3303ad4..f670798 100644
--- a/content/docs/dashboard/superwall-ai.mdx
+++ b/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."
---
-
+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.
-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.
## Opening it
@@ -23,15 +23,23 @@ 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:
+
+
+
+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:
+
+
+
+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
@@ -39,7 +47,7 @@ The composer's model picker switches the underlying AI model: Sonnet is the defa
## 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.
-
-
diff --git a/content/docs/images/ai_dash_context_aware_url_1.jpg b/content/docs/images/ai_dash_context_aware_url_1.jpg
new file mode 100644
index 0000000..82826f2
Binary files /dev/null and b/content/docs/images/ai_dash_context_aware_url_1.jpg differ
diff --git a/content/docs/images/ai_dash_context_aware_url_2.jpg b/content/docs/images/ai_dash_context_aware_url_2.jpg
new file mode 100644
index 0000000..5103644
Binary files /dev/null and b/content/docs/images/ai_dash_context_aware_url_2.jpg differ
diff --git a/content/shared/vibe-coding.mdx b/content/shared/vibe-coding.mdx
index ebf1af7..61faebd 100644
--- a/content/shared/vibe-coding.mdx
+++ b/content/shared/vibe-coding.mdx
@@ -7,7 +7,8 @@ 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.
@@ -15,15 +16,12 @@ We've built a few tools to help you Vibe Code using the knowledge of the Superwa
And right here in the Superwall Docs:
-- [Superwall AI](#superwall-ai)
- [Docs Links](#docs-links)
- [LLMs.txt](#llmstxt)
-## Superwall Agents
-
-[Superwall Agents](/agents) is the dedicated agent workspace at superwall.ai. 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
-
-
-
-[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).
-
-
-
## Docs Links
At the top of each page of the Superwall Docs (including this one!):