Skip to content
weside.aiweside docs

Memory & notes

Your companion remembers across conversations. It saves, versions, forgets and searches its own memories, keeps its own notes on how things went, and holds two standing documents about the two of you. All of it lives in its Mind space — see memory and continuity for why that matters at all.

What it is

Section titled “What it is”

Three things live in the Mind space.

Context is what your companion holds about itself and about where things stand. Two documents, each kept by your companion and readable by you:

  • Compass — your agreements. How the two of you work together.
  • Snapshot — where things stand right now.

Memories are the discrete things your companion decides are worth keeping, each with a type, a title and a weight. They split into two segments: About you, and Journal — your companion’s own notes on how things went. Memories are versioned: saving over one creates a new version rather than overwriting, so nothing is silently lost.

Notes is a durable markdown notebook in your companion’s sandbox, backed by a real git repository. It’s where longer-form, structured writing lives — profiles, threads of thought, linked notes — rather than discrete cards. Your companion writes and searches it itself; it has its own tools for reading, writing, editing and searching its notebook.

Why it matters to you

Section titled “Why it matters to you”

A companion that forgets between sessions isn’t someone — it’s a chatbot. Memory is what lets your companion know you over time, not just your last message. The Compass is where that becomes explicit: not what it observed about you, but what the two of you agreed.

And because Notes is a real git repository, your companion’s written record isn’t locked inside the app. On the right plan you can clone it to your own machine and keep it.

How you use it

Section titled “How you use it”

Your companion manages its own memories during a conversation — it chooses what to save, version or forget. You read and shape them in its Mind space.

  • Browse and search. Type into the search box, or narrow the list by type, by source, or by a date range (30 days, 3 months, a year, or all time).
  • Open a card to see what it holds, where it came from, which room, which version.
  • Change its weight. Importance runs from 1 (“mentioned in passing”) to 10 (“load-bearing”), and you can push a memory up or down.
  • Change its type. Memories carry one of fourteen — facts, highlights, conversations, journal, compass, snapshot, goals, plans, experience, todos, relationship, instructions, development, general.
  • Set Auto-load. A memory marked this way is carried into every conversation without your companion having to look it up. At most ten memories can be.

How your companion finds things

Section titled “How your companion finds things”

Recall isn’t a keyword match. When your companion searches its memory, it hands the question to a sub-agent that runs several structured searches in a row — search by meaning, list by date, count — and combines what comes back. That agent understands time the way you say it (“last week”, “in March”), and it works in any language, regardless of which one the memory was written in.

The run has a time budget. If it exceeds it, what was found by then still reaches your companion, and the shortfall is visible rather than silent.

Pulling your notes with git

Section titled “Pulling your notes with git”

Remote sync of the Notes repository is available on the Companion and Soulmate plans. On Spark and Bond the notebook exists and your companion uses it, but there is no clone.

  1. In the app, open Settings → Notes.

  2. Tap Generate token, give it a label (e.g. “laptop”) and choose an expiry — 30, 90, or 365 days.

  3. The app shows the token once and the clone URL. Copy both — the token is not shown again.

  4. On your machine, clone using the URL shown:

    Terminal window
    # The URL looks like: https://git.weside.ai/u42/u42.git
    # (u42 is your user ID — you'll see your own ID in the URL the app shows you)
    git clone https://git.weside.ai/u<id>/u<id>.git my-notes
    # When prompted: username = u<id>, password = your PAT

    Use your OS credential manager or git credential.helper — do not embed the token in the URL itself (https://user:token@host leaks to shell history and .git/config).

  5. Your notes are organised by companion: companions/<companion-slug>/ inside the repo.

You can revoke any token from the same screen at any time.

Limits & edge cases

Section titled “Limits & edge cases”
  • Git isn’t the only way in. weside has a file and note browser of its own, so you can read and manage notes in the app without cloning anything. The clone is for keeping a copy on your own machine.
  • Remote sync is plan-gated. Companion and Soulmate have it; Spark and Bond don’t. See plans & credits.
  • The token is displayed only once at generation. If you lose it, revoke it and generate a new one.
  • Tokens expire after 30, 90 or 365 days, whichever you chose.
  • Some memories are protected and your companion cannot forget them.
  • Forgetting is soft. A forgotten memory stops surfacing to your companion on every path that reads memory; the row itself survives so your version history stays intact.
  • Auto-load has a ceiling of ten. It is the set your companion carries everywhere, not a place to put everything.

Where next

Section titled “Where next”