Merge b108d771e3 into 3f7b9667c6

apps/docs/docs.json

@@ -399,33 +399,59 @@
 				"tab": "Plugins and MCP"
 			},
 			{
-				"tab": "Company Brain",
+				"tab": "Supermemory Brain",
 				"groups": [
 					{
-						"group": "Concepts",
+						"group": "Company Brain",
 						"pages": [
-							"company-brain/overview",
-							"company-brain/setup",
-							"company-brain/permissions",
-							"company-brain/connectors",
-							"company-brain/automations",
-							"company-brain/outside-slack"
+							{
+								"group": "Concepts",
+								"pages": [
+									"company-brain/overview",
+									"company-brain/setup",
+									"company-brain/permissions",
+									"company-brain/connectors",
+									"company-brain/automations",
+									"company-brain/outside-slack"
+								]
+							},
+							{
+								"group": "What you can do",
+								"pages": [
+									"company-brain/use-cases/overview",
+									"company-brain/use-cases/support",
+									"company-brain/use-cases/incidents",
+									"company-brain/use-cases/support-escalation",
+									"company-brain/use-cases/meeting-recall",
+									"company-brain/use-cases/knowledge-recall",
+									"company-brain/use-cases/acting-in-tools",
+									"company-brain/use-cases/greeting",
+									"company-brain/use-cases/sandbox-debugging",
+									"company-brain/use-cases/long-horizon-research",
+									"company-brain/use-cases/meeting-scheduling"
+								]
+							}
 						]
 					},
 					{
-						"group": "What you can do",
+						"group": "Personal Brain",
 						"pages": [
-							"company-brain/use-cases/overview",
-							"company-brain/use-cases/support",
-							"company-brain/use-cases/incidents",
-							"company-brain/use-cases/support-escalation",
-							"company-brain/use-cases/meeting-recall",
-							"company-brain/use-cases/knowledge-recall",
-							"company-brain/use-cases/acting-in-tools",
-							"company-brain/use-cases/greeting",
-							"company-brain/use-cases/sandbox-debugging",
-							"company-brain/use-cases/long-horizon-research",
-							"company-brain/use-cases/meeting-scheduling"
+							"personal-brain/concepts/what-is-supermemory-personal-brain",
+							"personal-brain/concepts/app-and-console",
+							"personal-brain/concepts/setup",
+							"personal-brain/concepts/spaces",
+							{
+								"group": "Integrations",
+								"icon": "plug",
+								"pages": [
+									"personal-brain/concepts/integrations",
+									"personal-brain/use-cases/poke",
+									"personal-brain/use-cases/browser-extension",
+									"personal-brain/use-cases/apple-shortcuts",
+									"personal-brain/use-cases/x-bookmarks",
+									"personal-brain/use-cases/raycast"
+								]
+							}
 						]
 					}
 				]

apps/docs/personal-brain/concepts/app-and-console.mdx

@@ -0,0 +1,57 @@
+---
+title: "Personal Brain and Developer Console"
+sidebarTitle: "App and Console"
+description: "Where to manage your memory and where to manage the API"
+icon: "panels-top-left"
+---
+
+## Two surfaces, one account
+
+You use the same Supermemory account across two surfaces. Personal Brain is where you live with your memory day to day. The Developer Console is where you manage the API.
+
+| Personal Brain | Developer Console |
+| --- | --- |
+| Save and search personal knowledge | API keys |
+| Chat with your memory | API usage |
+| Manage Spaces | Developer settings |
+| Connect personal tools | API-oriented connections |
+| Browse memories and documents | Plans and billing |
+
+## Organizations
+
+Your account can belong to more than one organization. The selected organization controls what data appears on both surfaces. Switch organizations from the selector before you save, search, or expect to see a specific memory.
+
+## Why memories sometimes look missing
+
+If something you saved isn't showing up, check two things first:
+
+- The **organization** currently selected
+- The **Space** you saved into, and the Space you're searching in
+
+## Where to go
+
+<CardGroup cols={3}>
+  <Card title="Open Personal Brain" icon="brain" href="https://app.supermemory.ai">
+    Save, search, and manage your memory.
+  </Card>
+
+  <Card title="Open Developer Console" icon="code" href="https://console.supermemory.ai">
+    API keys, usage, and developer settings.
+  </Card>
+
+  <Card title="Account and billing help" icon="life-buoy" href="https://supermemory.support.site/">
+    Get help with your account or plan.
+  </Card>
+</CardGroup>
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Setup" icon="rocket" href="/personal-brain/concepts/setup">
+    Save your first memory and find it again.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/concepts/integrations.mdx

@@ -0,0 +1,78 @@
+---
+title: "Integrations"
+sidebarTitle: "Overview"
+description: "Save and recall your memory from the tools you already use"
+icon: "plug"
+---
+
+Personal Brain integrations fall into four patterns: **save** something new, **recall** what you already have, **import** existing content, and **sync** an external source so it stays current.
+
+<Frame>
+  ![Integrations dashboard with MCP and plugins](/images/personal-brain/integrations-overview.png)
+</Frame>
+
+## The four patterns
+
+| Pattern | What it does | Examples |
+| --- | --- | --- |
+| Save | Adds something to memory | Apple Shortcuts, Raycast |
+| Recall | Searches memory from another tool | Poke, Raycast |
+| Import | Brings existing content into memory | X bookmarks, saved AI memories |
+| Sync | Keeps an external source current | Google Drive, Notion, OneDrive, Granola |
+
+## Available integrations
+
+<Frame>
+  ![Apps and extensions integration cards](/images/personal-brain/apps-and-extensions.png)
+</Frame>
+
+<CardGroup cols={2}>
+  <Card title="Poke" icon="https://poke.com/icons/poke-512.png" href="/personal-brain/use-cases/poke">
+    Save and recall by messaging Poke.
+  </Card>
+
+  <Card title="Browser extension" icon="globe" href="/personal-brain/use-cases/browser-extension">
+    Save webpages and selections from any tab.
+  </Card>
+
+  <Card title="Apple Shortcuts" icon="apple" href="/personal-brain/use-cases/apple-shortcuts">
+    Save from Share Sheet, Siri, and automations.
+  </Card>
+
+  <Card title="X bookmarks" icon="https://abs.twimg.com/responsive-web/client-web/icon-ios.77d25eba.png" href="/personal-brain/use-cases/x-bookmarks">
+    Import your existing X bookmarks into memory.
+  </Card>
+
+  <Card title="Raycast" icon="https://cdn.jsdelivr.net/gh/selfhst/icons/png/raycast.png" href="/personal-brain/use-cases/raycast">
+    Save and search from your launcher.
+  </Card>
+</CardGroup>
+
+## MCP and plugins
+
+Supermemory MCP connects compatible AI clients and coding agents to your Personal Brain so they can save and recall using the same memory. See [Supermemory MCP](/supermemory-mcp/mcp) for setup and supported clients.
+
+## Data connectors
+
+Data connectors keep external sources like Google Drive, Notion, OneDrive, and Granola synced into your memory. See [Connectors](/connectors/overview) for the full list and setup.
+
+## Which one should I use?
+
+- **Save a webpage you're reading** goes through the browser extension
+- **Save from your phone or via Siri** goes through Apple Shortcuts
+- **Save or recall from your launcher** goes through Raycast
+- **Save or recall by texting** goes through Poke
+- **Give a coding agent or AI client your memory** goes through MCP or a coding plugin
+- **Keep a whole external source current** goes through data connectors
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="What you can do" icon="sparkles" href="/personal-brain/use-cases/overview">
+    Save, search, import, and recall across your tools.
+  </Card>
+
+  <Card title="Supermemory MCP" icon="brain-circuit" href="/supermemory-mcp/mcp">
+    Connect MCP-compatible clients to your memory.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/concepts/setup.mdx

@@ -0,0 +1,75 @@
+---
+title: "Setup and Onboarding"
+sidebarTitle: "Setup"
+description: "Save your first memory and recall it from Personal Brain"
+icon: "rocket"
+---
+
+Get Personal Brain running by saving one thing, finding it again, then connecting it to a tool you already use.
+
+## Before you start
+
+- A Supermemory account
+- Open [app.supermemory.ai](https://app.supermemory.ai)
+- Confirm you're in the intended organization and Space before saving anything
+
+## Steps
+
+<Steps>
+  <Step title="Open Personal Brain">
+    Sign in and land in your Personal Brain workspace. Check the organization and Space selector before you save.
+  </Step>
+  <Step title="Save something">
+    Paste a note, drop a link, or upload a file. Wait for it to finish processing.
+
+    <Frame>
+      ![Add memory dialog with note, link, and file options](/images/personal-brain/add-memory.png)
+    </Frame>
+  </Step>
+  <Step title="Find it again">
+    Search for a distinctive word or phrase from what you saved. Confirm it appears.
+
+    <Frame>
+      ![Search palette for memories](/images/personal-brain/search.png)
+    </Frame>
+  </Step>
+  <Step title="Connect a tool">
+    Pick one integration below and set it up so you can save or recall without opening the app.
+  </Step>
+</Steps>
+
+## Choose your first integration
+
+<CardGroup cols={2}>
+  <Card title="Browser extension" icon="globe" href="/personal-brain/use-cases/ai-chats">
+    Save webpages and selections from any tab.
+  </Card>
+
+  <Card title="Poke" icon="messages-square" href="/personal-brain/use-cases/poke">
+    Save and recall by messaging Poke.
+  </Card>
+
+  <Card title="Apple Shortcuts" icon="apple" href="/personal-brain/use-cases/apple-shortcuts">
+    Save from Share Sheet, Siri, and automations.
+  </Card>
+
+  <Card title="Raycast" icon="command" href="/personal-brain/use-cases/raycast">
+    Save and search from your launcher.
+  </Card>
+</CardGroup>
+
+<Note>
+  **If your memory does not appear**, check three things: the organization you're in, the Space you saved into, and whether the memory has finished processing.
+</Note>
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    Save and recall your memory from the tools you already use.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/concepts/spaces.mdx

@@ -0,0 +1,77 @@
+---
+title: "Spaces"
+sidebarTitle: "Spaces"
+description: "Keep different parts of your memory organized and separate"
+icon: "layers"
+---
+
+Spaces let you keep different parts of your memory organized and separate. Save into the Space that matches the context, and search stays scoped to what you actually want back.
+
+## What a Space is
+
+A Space is a named container inside your Personal Brain. Common ways people split them:
+
+- **Personal** for life, notes, and reading
+- **Work** for your job in general
+- **Research** for a topic you're going deep on
+- **A client** you're working with
+- **A coding project** you switch in and out of
+
+## What a Space affects
+
+- **Where content is saved** when you add something new
+- **The scope of search** when you look something up
+- **What a connected tool can see** when it saves or recalls on your behalf
+
+## Create and select a Space
+
+<Steps>
+  <Step title="Create a Space">
+    From the Space selector in Personal Brain, create a new Space and give it a name that matches how you'll use it.
+
+    <Frame>
+      ![New space dialog with name field](/images/personal-brain/spaces-create.png)
+    </Frame>
+
+    Optionally, tell Nova what matters in this Space so it shapes which memories get extracted.
+
+    <Frame>
+      ![New space dialog with What to remember field](/images/personal-brain/spaces-context.png)
+    </Frame>
+  </Step>
+  <Step title="Select the active Space">
+    Switch to the Space you want before you save or search. New content goes into the active Space.
+
+    <Frame>
+      ![Space selector listing available Spaces](/images/personal-brain/spaces-selector.png)
+    </Frame>
+  </Step>
+</Steps>
+
+## Spaces and Projects
+
+Some coding tools use the word **Project** for a selected memory workspace. When you set up one of those tools, the Project you choose is how that tool refers to the Space it's pointed at.
+
+## Moving, merging, and deleting
+
+When you delete a Space, the app can offer to move its data to another Space before deletion so you don't lose what's inside.
+
+<Warning>
+  Don't delete a Space until you've confirmed the destination. Once a Space is deleted without moving its data, that content is gone.
+</Warning>
+
+## Connected tools
+
+Each connected tool saves and recalls against a specific workspace. When you set up an integration or switch which Space it uses, confirm the selected workspace inside that tool so its saves and searches land where you expect.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Setup" icon="rocket" href="/personal-brain/concepts/setup">
+    Save your first memory and find it again.
+  </Card>
+
+  <Card title="Manage your memory" icon="database" href="/personal-brain/use-cases/manage-memory">
+    Browse, edit, and organize what's in your Personal Brain.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/concepts/what-is-supermemory-personal-brain.mdx

@@ -0,0 +1,61 @@
+---
+title: "What is Supermemory Personal Brain?"
+sidebarTitle: "Overview"
+description: "One memory across the apps and AI tools you use"
+icon: "brain"
+---
+
+Personal Brain gives you one memory across the apps and AI tools you use. Save something once, then search it in Supermemory or recall it from a connected tool when you need it.
+
+<CardGroup cols={2}>
+  <Card title="Save" icon="bookmark">
+    Add notes, links, files, webpages, and content from connected apps.
+  </Card>
+
+  <Card title="Recall" icon="search">
+    Search your memory, ask questions, or bring relevant context into another AI tool.
+  </Card>
+</CardGroup>
+
+Ask questions and Nova pulls the right context from your memory.
+
+<Frame>
+  ![Nova chat with memory map](/images/personal-brain/nova-chat.png)
+</Frame>
+
+## A quick example
+
+<Steps>
+  <Step title="Save a project decision.">
+    Capture the decision in Supermemory so it's part of your memory.
+  </Step>
+  <Step title="Open a new chat in a supported AI tool.">
+    Start fresh without pasting background or context.
+  </Step>
+  <Step title="Recall the decision without explaining it again.">
+    Your memory is available in the tool, so the decision comes back on demand.
+  </Step>
+</Steps>
+
+## Where you can use it
+
+- Supermemory app
+- Browser extension
+- Poke
+- Apple Shortcuts
+- Raycast
+- MCP clients and coding plugins
+
+Personal Brain integrations, MCP clients, coding plugins, and data connectors all connect to the same memory but have different setup flows.
+
+## Where to go next
+
+<CardGroup cols={2}>
+  <Card title="Setup" icon="rocket" href="/personal-brain/concepts/setup">
+    Save your first memory and find it again.
+  </Card>
+
+  <Card title="What you can do" icon="sparkles" href="/personal-brain/use-cases/overview">
+    Save, search, import, and recall across your tools.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/use-cases/apple-shortcuts.mdx

@@ -0,0 +1,69 @@
+---
+title: "Use Supermemory with Apple Shortcuts on iPhone, iPad, and Mac"
+sidebarTitle: "Apple Shortcuts"
+description: "Learn how to add and search Supermemory Personal Brain memories from iPhone, iPad, and Mac using the Apple Shortcuts app."
+icon: "apple"
+---
+
+Add and search memories from Apple devices using Shortcuts.
+
+## How Apple Shortcuts works with Supermemory
+
+Apple Shortcuts adds memories from iPhone, iPad, or Mac. Two shortcuts are provided: Add memory and Search memory.
+
+## Before you start
+
+- A Supermemory account with Personal Brain access
+- Signed in at [app.supermemory.ai](https://app.supermemory.ai)
+- An iPhone, iPad, or Mac with the Shortcuts app
+- The active organization and Space you want to save into
+
+## How to install the Add memory and Search memory shortcuts
+
+<Steps>
+  <Step title="Open Integrations in Personal Brain">
+    Go to Integrations and select Apple Shortcuts.
+  </Step>
+  <Step title="Install the shortcut from Personal Brain Integrations">
+    Install Add memory and Search memory from the links in Personal Brain. Do not paste an API key or credential into the shortcut manually.
+  </Step>
+  <Step title="Choose the correct Space">
+    Select the Space you want the shortcut to use before saving.
+  </Step>
+  <Step title="Run Add memory to test">
+    Run the Add memory shortcut with a short note, then run Search memory to find it.
+  </Step>
+</Steps>
+
+## How the shortcuts call Supermemory
+
+The shortcuts call Supermemory from your Apple device. Add memory sends the input to your active Space. Search memory queries the same Space and returns matches.
+
+## What Apple Shortcuts saves and searches
+
+- Save: text, links, or content passed to Add memory, including from the Share Sheet or Siri
+- Search: your memory in the Space the shortcut is pointed at
+
+## Limitations of the Apple Shortcuts integration
+
+- Install the shortcut from Personal Brain Integrations so it comes preconfigured. Never expose or share an API key or credential.
+- Saves and searches run against the Space selected in setup. Switching Spaces requires reconfiguring the shortcut.
+- Share Sheet behavior varies by app. Some apps only pass a URL, others pass selected text.
+
+## How to troubleshoot Apple Shortcuts
+
+- **The shortcut fails to run.** Confirm the active organization and Space, and that you installed the shortcut from Personal Brain Integrations.
+- **A saved memory did not appear.** Check that it finished processing and lives in the Space the shortcut targets.
+- **Search returns nothing.** Confirm the Space matches where you saved earlier, and that connection status is active.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    See every way to save and recall from Personal Brain.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/use-cases/browser-extension.mdx

@@ -0,0 +1,145 @@
+---
+title: "Supermemory Chrome Extension: Save Webpages, Conversations, and Bookmarks"
+sidebarTitle: "Browser extension"
+description: "Learn how to use the Supermemory Chrome extension to save webpages and AI conversations, import ChatGPT memories and X bookmarks, and organize them in your Personal Brain."
+icon: "globe"
+---
+
+Save webpages and conversations from Chrome without leaving the tab.
+
+## How the Supermemory Chrome extension works
+
+The Supermemory Chrome Extension has two main actions. Use **Save** for the webpage or conversation open in your current tab. Use **Imports** to bring existing ChatGPT memories or X bookmarks into your Personal Brain.
+
+## Before you start
+
+- A Supermemory account with Personal Brain access
+- Signed in at [app.supermemory.ai](https://app.supermemory.ai)
+- Google Chrome
+- The active organization and Space you want to save into
+
+## How to install and connect the Chrome extension
+
+<Steps>
+  <Step title="Open Integrations in Personal Brain">
+    Go to Integrations and select Browser extension.
+  </Step>
+  <Step title="Install the Chrome Extension">
+    Add the extension from the Chrome Web Store.
+  </Step>
+  <Step title="Sign in through the extension">
+    Sign in to Supermemory from the extension so it saves into your account.
+  </Step>
+  <Step title="Choose the correct Space">
+    Select the Space that matches the context you're saving into before you save anything.
+  </Step>
+  <Step title="Save a page to confirm">
+    Open a page and use the extension to save it. Check that it appears in the chosen Space.
+  </Step>
+</Steps>
+
+## Save webpages and conversations to Supermemory
+
+Use **Save** when you want to add something from the tab you are viewing. This works for webpages and supported AI conversations, including ChatGPT and Claude.
+
+<Steps>
+  <Step title="Open the page or conversation">
+    Go to the webpage, ChatGPT conversation, or Claude conversation you want to save.
+  </Step>
+  <Step title="Open the Supermemory extension">
+    Select the Supermemory icon in the Chrome toolbar and stay on **Save**.
+  </Step>
+  <Step title="Choose a Space">
+    Confirm where you want the page or conversation to be saved.
+  </Step>
+  <Step title="Add it to Supermemory">
+    Select **Add to supermemory**.
+  </Step>
+</Steps>
+
+<Frame>
+  <img src="/images/personal-brain/save-page-with-supermemory-extension.webp" alt="Opening the Supermemory Chrome extension and selecting Add to supermemory to save the current page" />
+</Frame>
+
+The saved page or conversation becomes available in the selected Space alongside the rest of your Personal Brain.
+
+### What Save captures
+
+- Save: the current webpage and, optionally, a selection or note
+- Save: a supported AI conversation using **Add to supermemory**
+
+## Import existing content into Supermemory
+
+Use **Imports** for supported bulk imports. Imports do not depend on the page currently open in your tab.
+
+### How to import ChatGPT memories into Supermemory
+
+Use the extension's import option to bring your existing ChatGPT memories into your Personal Brain. This imports the memories ChatGPT has already saved about you. It is different from saving one ChatGPT conversation.
+
+<Steps>
+  <Step title="Open the Supermemory extension">
+    Select the Supermemory icon in the Chrome toolbar.
+  </Step>
+  <Step title="Open Imports">
+    Select **Imports** at the top of the extension.
+  </Step>
+  <Step title="Choose Import ChatGPT memories">
+    Select the option to import your existing ChatGPT memories.
+  </Step>
+  <Step title="Complete the import">
+    Follow the instructions shown by the extension and wait for the import to finish.
+  </Step>
+</Steps>
+
+<Frame>
+  <img src="/images/personal-brain/chatgpt-memory-import.png" alt="Supermemory Chrome extension Imports tab showing the Import ChatGPT Memories option" />
+</Frame>
+
+Your imported ChatGPT memories become available in your Personal Brain alongside content saved from webpages, conversations, and other integrations.
+
+### How to import X bookmarks into Supermemory
+
+Use the X bookmark importer to bring your existing saved posts into your Personal Brain.
+
+<Steps>
+  <Step title="Open the Supermemory extension">
+    Select the Supermemory icon in the Chrome toolbar.
+  </Step>
+  <Step title="Open Imports">
+    Select **Imports** at the top of the extension.
+  </Step>
+  <Step title="Choose Import X/Twitter Bookmarks">
+    Select the X bookmark import option. The extension opens the import flow automatically.
+  </Step>
+  <Step title="Complete the import">
+    Follow the instructions shown by the extension and wait for the import to finish.
+  </Step>
+</Steps>
+
+For more detail, see [How to import X bookmarks into Supermemory](/personal-brain/use-cases/x-bookmarks).
+
+## Limitations of the browser extension
+
+- Chrome is the supported browser. Other browsers are not covered here.
+- Saves land in the active Space chosen in the extension. Confirm the Space before saving.
+- ChatGPT memory and X bookmark imports are import actions. They are not live syncs.
+
+## How to troubleshoot the Chrome extension
+
+- **A saved page did not appear.** Check the active organization, active Space in the extension, and that the memory finished processing.
+- **Sign in loops.** Sign in to Supermemory at [app.supermemory.ai](https://app.supermemory.ai) first, then reopen the extension.
+- **ChatGPT memories did not import.** Confirm ChatGPT and Supermemory are signed in through the same Chrome profile, then reopen **Imports** and try again.
+- **X bookmarks did not import.** Confirm you're signed in to X in the same Chrome profile, then reopen **Imports** and try again.
+- **Add to supermemory did not work.** Confirm you're signed in to Supermemory, the page or conversation is open in the same Chrome profile as the extension, and the correct Space is selected.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    See every way to save and recall from Personal Brain.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/use-cases/poke.mdx

@@ -0,0 +1,75 @@
+---
+title: "Connect Poke to Supermemory: Save and Recall Memories by Text"
+sidebarTitle: "Poke"
+description: "Learn how to connect Poke to Supermemory and save or recall Personal Brain memories from a text message."
+icon: "/images/personal-brain/integration-logos/poke.png"
+---
+
+Save and recall from your Personal Brain by texting Poke.
+
+## How Poke works with Supermemory
+
+Poke lets you save something to memory and recall it later by messaging Poke over text. No app switch, no dashboard.
+
+## Before you start
+
+- A Supermemory account with Personal Brain access
+- Signed in at [app.supermemory.ai](https://app.supermemory.ai)
+- The active organization and Space you want Poke to use
+
+## How to connect Poke to Supermemory
+
+<Steps>
+  <Step title="Open Integrations in Personal Brain">
+    Go to Integrations and select Poke.
+  </Step>
+  <Step title="Open the Poke recipe">
+    The connect flow opens the Poke recipe for Supermemory.
+  </Step>
+  <Step title="Review the recipe warning">
+    The recipe currently shows an unverified recipe warning. Read what the recipe does before you continue.
+
+    <Frame>
+      ![Poke unverified recipe warning](/images/personal-brain/poke-unverified-recipe-warning.png)
+    </Frame>
+  </Step>
+  <Step title="Enable the recipe">
+    Confirm in Poke to enable the recipe against your Supermemory account.
+  </Step>
+  <Step title="Message Poke to test">
+    Text Poke to save a note, then ask Poke to recall it.
+  </Step>
+</Steps>
+
+## How the Poke recipe calls Supermemory
+
+Poke calls Supermemory through the recipe. Messages that save something add a memory to your active Space. Messages that ask for something search your memory and reply with the answer.
+
+## What Poke saves and searches
+
+- Save: the message content you send Poke to save
+- Search: your memory, scoped to the Space Poke is connected to
+
+## Limitations of the Poke integration
+
+- The Poke recipe currently displays an unverified recipe warning. Review the recipe before enabling it.
+- Saves and recalls run against the Space selected during setup. Switching Spaces requires reconfiguring the recipe.
+- Rich content like files is best added from the Supermemory app or a Space aware integration.
+
+## How to troubleshoot Poke
+
+- **Nothing was saved.** Check the active organization and Space, and confirm the Poke recipe is enabled.
+- **A recall came back empty.** Confirm the memory finished processing in Personal Brain and that it lives in the Space Poke is pointed at.
+- **Poke says it is not connected.** Reopen the recipe from Personal Brain Integrations and confirm the connection status.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    See every way to save and recall from Personal Brain.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/use-cases/raycast.mdx

@@ -0,0 +1,77 @@
+---
+title: "Use Supermemory with Raycast: Save and Search Memories on Mac"
+sidebarTitle: "Raycast"
+description: "Learn how to use the Supermemory Raycast extension to add and search Personal Brain memories from the Raycast command bar on macOS."
+icon: "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20xml%3Aspace%3D%22preserve%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M128.1%20330.5v53.4L0%20255.8l26.8-26.7zm53.4%2053.4h-53.4L256.2%20512l26.7-26.7zm303.8-101.3%2026.7-26.7L256.1%200l-26.7%2026.7L330.5%20128h-61.1l-70.6-70.5L172%2084.1l44%2044h-30.6v198.6H384v-30.6l44%2044%2026.7-26.7-70.7-70.8v-61.1zm-343.9-168-26.7%2026.7%2028.6%2028.6%2026.7-26.7zm227.3%20227.3-26.6%2026.7%2028.6%2028.6%2026.7-26.7zm-284.6-170-26.7%2026.7%2070.7%2070.7v-53.5zm212%20212h-53.4l70.7%2070.7%2026.7-26.7z%22%20style%3D%22fill-rule%3Aevenodd%3Bclip-rule%3Aevenodd%3Bfill%3A%23ff6363%22%2F%3E%3C%2Fsvg%3E"
+iconType: "regular"
+---
+
+Add and search your memory from the Raycast command bar on Mac.
+
+<Frame>
+  ![Raycast connect Supermemory command](/images/personal-brain/raycast.png)
+</Frame>
+
+## How the Supermemory Raycast extension works
+
+Adds memories from Raycast on Mac and searches Supermemory directly from the desktop command bar.
+
+## Before you start
+
+- A Supermemory account with Personal Brain access
+- Signed in at [app.supermemory.ai](https://app.supermemory.ai)
+- Raycast installed on macOS
+- The active organization and Space you want to use
+
+## How to install and connect the Raycast extension
+
+<Steps>
+  <Step title="Open Integrations in Personal Brain">
+    Go to Integrations and select Raycast.
+  </Step>
+  <Step title="Install the Raycast extension">
+    Install the Supermemory extension from the Raycast store.
+  </Step>
+  <Step title="Connect your account">
+    Sign in from the extension so Raycast can save and search in your Supermemory account.
+  </Step>
+  <Step title="Choose the correct Space">
+    Select the Space you want the commands to use.
+  </Step>
+  <Step title="Try Add memory and Search memory">
+    Run the add and search commands from Raycast to confirm the connection.
+  </Step>
+</Steps>
+
+## How Raycast talks to Supermemory
+
+Raycast talks to Supermemory through the extension. Add memory sends the input to your active Space. Search memory queries the same Space and shows matches inline.
+
+## What Raycast saves and searches
+
+- Save: text, links, or selections passed to the add command
+- Search: your memory in the Space Raycast is pointed at
+
+## Limitations of the Raycast extension
+
+- Raycast runs on macOS. Other launchers are not covered here.
+- Commands run against the active Space chosen in the extension. Confirm it before saving or searching.
+- Some commands rely on macOS accessibility and clipboard permissions granted to Raycast.
+
+## How to troubleshoot Raycast
+
+- **Commands don't run.** Confirm you're signed in from the extension and the connection status is active.
+- **A saved memory did not appear.** Check the active organization and Space, and that processing finished.
+- **Search returns nothing.** Confirm the Space matches the one you saved into.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    See every way to save and recall from Personal Brain.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>

apps/docs/personal-brain/use-cases/x-bookmarks.mdx

@@ -0,0 +1,73 @@
+---
+title: "Import X Bookmarks into Supermemory and Search Saved Posts"
+sidebarTitle: "X bookmarks"
+description: "Learn how to import your X (Twitter) bookmarks into Supermemory and search saved posts alongside the rest of your Personal Brain."
+icon: "/images/personal-brain/integration-logos/x.png"
+---
+
+Bring your saved posts on X into your Personal Brain so you can search and reuse them.
+
+## How the X bookmarks import works
+
+Imports saved X posts into Supermemory as searchable memories, so bookmarked social research is reusable alongside the rest of your memory.
+
+<Frame>
+  ![Import X bookmarks dialog](/images/personal-brain/x-bookmarks.png)
+</Frame>
+
+## Before you start
+
+- A Supermemory account with Personal Brain access
+- Signed in at [app.supermemory.ai](https://app.supermemory.ai)
+- Access to your X account
+- The active organization and Space you want the bookmarks saved into
+
+## How to import X bookmarks into Supermemory
+
+<Steps>
+  <Step title="Open Integrations in Personal Brain">
+    Go to Integrations and select X bookmarks.
+  </Step>
+  <Step title="Choose the destination Space">
+    Confirm the active Space where the imported bookmarks should live.
+  </Step>
+  <Step title="Start the import">
+    Follow the prompt to connect your X account and begin the import.
+  </Step>
+  <Step title="Wait for processing">
+    Bookmarks are added as memories and finish processing before they're searchable.
+  </Step>
+</Steps>
+
+## How the X bookmarks integration turns posts into memories
+
+The integration reads your existing X bookmarks and adds each one as a memory in the selected Space. Search picks them up once processing completes.
+
+## What the X bookmarks import saves and searches
+
+- Save: your existing X bookmarks as memories
+- Search: those bookmarks alongside everything else in the same Space
+
+## Limitations of the X bookmarks import
+
+- This is an import of existing bookmarks, not a continuous sync unless the product UI explicitly says so.
+- Imports land in the Space selected at the start of the import. Move memories between Spaces from Personal Brain if you picked the wrong one.
+- Large bookmark libraries take longer to finish processing.
+
+## How to troubleshoot the X bookmarks import
+
+- **Bookmarks didn't appear.** Check the active organization, active Space, and connection status for the X integration.
+- **Some bookmarks are missing.** Confirm the import finished and that individual memories finished processing.
+- **Search doesn't return a bookmark.** Confirm the Space you're searching matches the Space the import landed in.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Integrations" icon="plug" href="/personal-brain/concepts/integrations">
+    See every way to save and recall from Personal Brain.
+  </Card>
+
+  <Card title="Spaces" icon="layers" href="/personal-brain/concepts/spaces">
+    Keep different parts of your memory organized and separate.
+  </Card>
+</CardGroup>