Skip to content
Docs menu

How Notes learns

What Venom Notes adds to your vault on its own, where it gets it from, how you review it in the Inbox, and how its spending is capped.

View .md

Venom Notes keeps a vault of notes for you and for your org. Besides the notes people write, Notes reads new material as it arrives, works out what it adds to the notes you have, and suggests the changes. Nothing it suggests is hidden: every change is in the Inbox, says where it came from, and can be undone.

Where new material comes from

Source When Lands in
Capture You paste text or upload a file (.md, .txt, .html; up to 5 MB, 50,000 characters) in the Inbox the vault you capture into
Session summaries Every 15 minutes, if your org collects session summaries (turned on in the console under Sessions → History) the personal vault of the member whose session it was
Claude Code sessions Same as session summaries, once the Claude Code plugin is installed the personal vault of the member whose key sent it
Org memory Every 15 minutes the org vault's Memory/ folder, one note per approved fact
ChatGPT and Claude You import conversations from your data export, or paste what your AI remembers, in Settings (Import from ChatGPT and Claude) the vault you pick (your own by default)

PDF files are not read yet: copy the text and paste it instead. Notes never fetches a URL for you.

Text that looks like a secret (an API key, a token, a private key) is refused at capture and skipped from summaries. The original you captured is kept as it was, so you can always see what a suggestion was based on.

Memory/ mirrors org memory: approve, edit or retire a fact on the Memory page and the note follows. The folder is read-only in Notes.

What Notes suggests

For each new source, Notes reads the source along with the notes most related to it and suggests:

  • Add to a note: a paragraph for an existing note, under the right heading. Notes prefers this to making a new note.
  • New note: one idea per note, with links to the notes it relates to.
  • Link two notes: a line under "Related" that says why they belong together.
  • Conflict: the source disagrees with a note. Both sides are quoted, and Notes never decides which is right.

Every paragraph Notes adds carries a citation in the note's Sources section, pointing to the source it came from. When a folder or tag holds five or more notes, Notes also keeps a "Map of …" note that links them all.

Answers that don't fit these rules (a path outside the vault, a link to a note that doesn't exist, a secret, a conflict that doesn't quote the source) are dropped, never written.

Agents connected over MCP, such as Claude Code, can file suggestions into the same Inbox. Theirs are marked "Suggested by <app> via MCP" and always wait for you, even in your personal vault. An agent may also suggest a rewrite of a whole note. A rewrite applies only if the note hasn't changed since the agent read it; otherwise it is marked for you to compare by hand.

The Inbox

Inbox in the top bar of Notes (/globe/inbox) opens it for the vault you have open. Its badge counts what waits for review. Capture is at the top, then the suggestions, then "What came in": each source and whether Notes has read it.

  • Your personal vault: the suggestions Notes makes itself are applied for you as they arrive and listed as "Added for you". Undo puts the note back as it was. Conflicts always wait for you, and so does everything learned from an import from ChatGPT or Claude or a pasted memory list.
  • The org vault: suggestions wait until someone with permission to manage the org applies or rejects them. You can edit a suggestion before applying it, or apply all of them at once (conflicts and rewrites excepted).

Undo is refused once someone has edited the note since. The note's history can still restore an earlier version.

Separately from sources, Notes looks at the vault itself once a day (about 03:00 UTC) and suggests links between notes that belong together but are not linked:

  • Two notes that read alike or that share a specific topic (a person, an organisation, a term), with the reason: "Covers the same ground as Capital vs revenue" or "Both notes mention CPF, Okta". These come from the graph's similar and topic lines, so they need an embedding model (and, for topics, a model to read the notes).
  • A note nothing links to or from (no link, no database, no sub-page), with the note it is closest to.

They are ordinary link suggestions in the Inbox, marked "globe:semantic". They always wait for you, even in your personal vault. Accept writes the link into the passage of the note where it reads best: the target's name in that paragraph becomes the link, or "See [[…]]" closes it; if the passage has moved, the link goes under "Related" as for any link suggestion. Reject is remembered: the pair is never suggested again. Undo works as for the others.

So the Inbox is not flooded: at most 5 a week per vault, best first, at most one in any note and two into any note in a batch, at most two of them for orphan notes, and none while 10 wait. Notes under two days old are left for you to link by hand. A suggestion costs no model call.

Keeping notes fresh

A note is marked stale after 180 days in which nobody edited it, confirmed it or linked to it. A note's side pane shows how fresh it is and why. "Confirm still true" there resets the clock without changing the note. Edits Notes makes itself don't count as a person keeping the note fresh.

Spending

The suggestions in Notes are written by your org's summary model (the summary role of your default gear), and the requests are booked to your org like any other, with source globe. A daily cap limits them: $2 a day by default. When the day's spend reaches the cap, Notes stops reading new material until the next UTC day, and sources wait in the queue.

Admins (permission to manage the org) can change the cap (up to $200 a day) and turn session summaries or the memory mirror off on the Notes settings page, which also shows today's spend. The cap is also on the AI spend page with every other product's daily AI limit; Forms drafts count toward it too.