Spaces
Personal, Inbox and your own spaces, each with its own memory, files and instructions, and how an AI picks the right one.
A space is a place for one part of your life or work, with its own memory, files and persona (instructions for how the AI should act there). Memory never crosses between spaces: a search in one space only returns that space's memories. The dashboard calls spaces workspaces; the MCP tools say space. They are the same thing.
The three kinds
space_id | Memory | Files | Name, persona, use for | In the iPhone app | |
|---|---|---|---|---|---|
| Personal | personal | yes | no | fixed | yes, the same memory |
| Inbox | inbox | yes | yes | only use for can change | no |
| Your own spaces | dsp_… | yes | yes | all editable | no |
Personal
Personal is you: your life, preferences, people, routines, health and plans. It is the same memory your friend uses in the Omni iPhone app. A fact an AI app saves to Personal shows up in the app, and what you tell your friend in the app is there when an AI app searches Personal.
- An app can use Personal only if you ticked Your Omni memory when you connected it.
- Personal has no files, and its name, persona and use for are fixed.
- Each memory keeps a label of where it came from, such as
ClaudeorOmni app.
Inbox
One per account, made the first time it's needed. When an AI isn't sure where something belongs it saves it here, and remember without a space_id always lands here. Sort it later on the dashboard. Every connected app can use the Inbox.
Your own spaces
Make them on the dashboard, or ask your AI to (create_space). Templates give you a ready persona, a use for line and a starter file:
| Template | Use for | Starter file |
|---|---|---|
| Startup coach | My startup: goals, customers, metrics, decisions and weekly priorities. | playbook.md |
| Job search | My job search: target roles, applications, interviews, contacts and follow-ups. | job-tracker.md |
| Study buddy | What I am studying: topics, deadlines, notes, and questions I got wrong. | study-plan.md |
| Client project | One client project: brief, scope, decisions, contacts, deadlines and meeting notes. | project-brief.md |
| Blank | Whatever you write. | none |
The free plan has three spaces of your own, on top of Personal and Inbox (Free limits).
Use for: how an AI picks a space
Every space has a use for line of up to 300 characters, returned by list_spaces. Omni gives every connected AI the same rules when it connects:
- Start with
list_spaces. - Pick the one space whose use for matches what you're saving or looking up. If two fit, ask you once which one, then keep using it.
- Never save the same fact to two spaces.
- Search before advising: call
search_memoryon the space you're working in and build on what's there. - Anything unclear goes to the Inbox.
- In a space with a persona, read it (
get_space_persona) and adopt it. Save durable facts withremember, one short, self-contained sentence each. - If a tool says Omni's free limit is reached, tell you in plain words.
So the clearer a use for line, the better the AI files things. "Client work for Acme: scope, contacts, deadlines" beats "Work".
Memories
A memory is one short, self-contained sentence, up to 2,000 characters, such as "Their startup, Lumen, sells AI bookkeeping to dentists."
- Topic: an optional short label (up to 60 characters, such as
pricing). Saving a memory with the same topic in the same space replaces the older one, so facts that change stay current. - Kind: optional, one of
profile_fact,goal,project,preference,commitment,routine,constraint,note_summaryorrelationship. - Search:
search_memorymatches the words you search for, then tries the longer words one by one. It is word matching, not semantic search. With an empty query, or when nothing matches, it returns the 25 most recent memories in the space.
Files
Spaces other than Personal hold text and Markdown files (.md, .markdown, .txt): playbooks, plans, notes. Paths may use folders, such as plans/week-1.md. Your AI reads and writes them with list_files, read_file and write_file, and they're also offered as MCP resources.
Personas
A persona is up to 8,000 characters of instructions for how the AI should behave in a space, such as a warm, direct startup coach. Your AI reads it with get_space_persona, and each of your spaces is also an MCP prompt that starts a session in that persona.
While a new account is set up
A brand-new account takes a couple of minutes to set up. Until it's ready, list_spaces shows Personal with a status other than ready (usually provisioning), remember on Personal answers saved_pending (the memory is kept and moved in automatically), and search_memory on Personal says the memory is still being set up. Inbox and your own spaces work straight away.