Skip to documentation
Omni Docs

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_idMemoryFilesName, persona, use forIn the iPhone app
Personalpersonalyesnofixedyes, the same memory
Inboxinboxyesyesonly use for can changeno
Your own spacesdsp_…yesyesall editableno

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 Claude or Omni 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:

TemplateUse forStarter file
Startup coachMy startup: goals, customers, metrics, decisions and weekly priorities.playbook.md
Job searchMy job search: target roles, applications, interviews, contacts and follow-ups.job-tracker.md
Study buddyWhat I am studying: topics, deadlines, notes, and questions I got wrong.study-plan.md
Client projectOne client project: brief, scope, decisions, contacts, deadlines and meeting notes.project-brief.md
BlankWhatever 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:

  1. Start with list_spaces.
  2. 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.
  3. Never save the same fact to two spaces.
  4. Search before advising: call search_memory on the space you're working in and build on what's there.
  5. Anything unclear goes to the Inbox.
  6. In a space with a persona, read it (get_space_persona) and adopt it. Save durable facts with remember, one short, self-contained sentence each.
  7. 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_summary or relationship.
  • Search: search_memory matches 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.