Skip to content
weside.aiweside docs

Memory & notes

Your companion remembers across conversations — it saves, versions, forgets, and searches its own memories — and keeps a durable, git-backed Notes notebook you can pull to your own machine.

What it is

Section titled “What it is”

Two distinct things live in the Mind space.

Conscious memory is what your companion deliberately keeps: things it decides are worth holding onto, saved with a type and a title. Memories are versioned — saving over an existing one creates a new version rather than overwriting, so nothing is silently lost. Forgetting is a soft-delete: a forgotten memory stops surfacing but stays loadable by its ID.

Notes is a separate, durable markdown notebook stored 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 memory cards.

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. And because Notes is a real git repo, your companion’s written record isn’t locked inside the app: 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 conversation — it chooses what to save, version, or forget. You browse and search them yourself in the Mind space inside chat: open Mind to see the memory cards, type into the search box to find a memory, and open a card to read, edit, or forget that memory.

Recall works by meaning, not just keywords — your companion searches its memories semantically, so a question phrased differently from how something was stored still finds it.

To pull your Notes to your own machine via git:

  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”
  • 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. After that, generate a fresh one.
  • Notes for each companion live under companions/<slug>/ in the repo root.
  • Some system memories are protected and cannot be forgotten.
  • Forgetting is soft: the memory stops appearing but remains retrievable by ID, by design.

Where next

Section titled “Where next”