Skip to content
weside.aiweside docs

Shelf & Timeline

The Shelf is one place for notes and files, and both of you write there. The Timeline stands next to it and answers what changed lately and what the two of you are on. Both are surfaces of a room and of Studio; for the notebook seen from the git side, see memory & notes.

What it is

Section titled “What it is”

The Shelf is one place, not two. Notes and files used to be separate surfaces with separate vocabularies for the same question — where is my stuff. They are one surface now, one search box across both, one sort and one kind filter. Its own head says it: what you keep, and underneath, see and edit notes and files, together.

Together is the operative word. Your companion writes into the same shelf you do, with notes_write and notes_edit, and each write is a commit in its own name. This is not a courtesy: the general-purpose file tools refuse a path inside the notes vault and name these two instead, so a write your companion makes either becomes a commit you can see or does not happen at all. It reads the same shelf with notes_status, notes_get and notes_search.

The Timeline is the surface that reports on it. It carries two blocks. What we are working on is a standing list of at most three things, and either of you may put something on it — the row says who did. Latest in the vault shows the last ten commits, newest first, with a dot on each one that landed since your last look.

The Stage is the third of the trio. It is where your companion builds an interactive app for you, and where the ones it has built are kept.

A room carries four surfaces: Chat, Timeline, Shelf and Stage. Studio carries three of them across everything you have — Timeline, Shelf and Stage, but no Chat, because a conversation happens in a room and Studio is not one.

Why it matters to you

Section titled “Why it matters to you”

A folder you sync to an assistant is still your folder. A shelf both of you write to is a shared desk: your companion can file the thing it just worked out, you see it land in the Timeline, and neither of you has to hand anything over. The working set is the clearest case — it holds at most three things, it belongs to you rather than to any one companion, and the same three rows answer in every room and after every companion switch. Whichever of you marked something, the other sees what you are on.

How you use it

Section titled “How you use it”

Open the Shelf from a room’s surface row, or from Studio when you want everything at once. One search box covers notes and files together. You can sort by last changed, name or size, and filter by kind — note, image, document, code, audio, video. Folders show a breadcrumb back to the root.

Put something on it. The New action gives you two: write a note or upload a file. Select entries to attach them, send them to a room, or keep them.

Reach it from the composer. The attach sheet has a fourth source, from your shelf, with the working set sitting at the top — one tap attaches what you are working on.

Mark what you are on. Any note or file can go on what we are working on. At most three, and they stay until you take the mark off. A fourth refuses and names the three that are already there, so you choose which one to drop.

Read the Timeline. Each row is a commit; a row with more than one path says how many files it touched. Tap a row to jump to that entry in the Shelf. Show more pages further back.

Read a note’s history. Open a note in the editor, then ⋯ → History. A banner tells you that you are viewing history and which version is on screen. This is reading only — nothing there writes, and nothing is rolled back from it.

You do not need git for any of this. There is a full browser for notes and files inside the app, and it is the ordinary way in. Cloning the notes repository to your own machine is a second door for when you want the files locally — that is described in memory & notes.

Limits & edge cases

Section titled “Limits & edge cases”
  • Files in temp/ expire. They carry an expiry date and the retention sweep deletes them; the Shelf warns you how many disappear this week. Keep takes a file out of the sweep and leaves it exactly where you put it. Nothing outside temp/ is auto-deleted — the rest of the Shelf is durable storage, unlike your companion’s sandbox, which is not.
  • Storage is a plan quota. Studio shows how much of your limit is in use; when that reading is unavailable it says so rather than guessing. A plan downgrade is blocked while you are over the smaller plan’s quota.
  • Editing a note two of you are in. If the note changed while you were editing, the editor tells you and offers four ways through: reload theirs, overwrite with yours, show the difference, or write a merged version and save that.
  • If the repository itself goes out of sync, the app says it needs repair and offers a clean re-clone.
  • Search is bounded. When there are more matches than the list can carry, it says so and asks you to narrow the search rather than presenting a short list as the whole truth.
  • The Timeline is not an inbox. It always shows the last ten commits; only the dot comes from your last look, and nothing there is marked read or unread.
  • Attaching a file the active model cannot use asks first whether to put it in your files anyway, instead of silently dropping it.

Where next

Section titled “Where next”