-
Notifications
You must be signed in to change notification settings - Fork 2.5k
Add Personal Brain documentation #1466
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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> | ||
|  | ||
| </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> | ||
|  | ||
| </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"> | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Replace the external icon URL 'https://cdn.jsdelivr.net/gh/selfhst/icons/png/raycast.png' in the Raycast Card component with a stable local asset path (e.g., the already-added '/images/personal-brain/integration-logos/raycast-user-approved.svg') or a standard icon name to avoid broken link CI failures. Spotted by Graphite (based on CI logs) |
||
| 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> | ||
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
| @@ -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> | ||||||||
|  | ||||||||
| </Frame> | ||||||||
| </Step> | ||||||||
| <Step title="Find it again"> | ||||||||
| Search for a distinctive word or phrase from what you saved. Confirm it appears. | ||||||||
|
|
||||||||
| <Frame> | ||||||||
|  | ||||||||
| </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"> | ||||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Broken link: The href points to Fix: <Card title="Browser extension" icon="globe" href="/personal-brain/use-cases/browser-extension">
Suggested change
Spotted by Graphite |
||||||||
| Save webpages and selections from any tab. | ||||||||
| </Card> | ||||||||
|
|
||||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Broken link: This links to
Suggested change
|
||||||||
| <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> | ||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Replace the external icon URL 'https://poke.com/icons/poke-512.png' in the Poke Card component with a stable local asset path or a standard Mintlify icon name (e.g., icon="message") to avoid broken link CI failures.
Spotted by Graphite (based on CI logs)

Is this helpful? React 👍 or 👎 to let us know.