We use cookies to measure site usage with Google Analytics. We only turn that on if you say yes. See our Privacy Policy.

Documentation

Reservoirs Are Now Brains

Content Reservoirs were folded into brains. Where your reservoirs, keywords and captured items went, and which tools to use now.

BlackOps used to have two places for knowledge: reservoirs and brains. Now it has one. Every reservoir was moved onto a brain, its monitoring became a brain watch, and the Reservoirs pages are gone from the app. This page is the short version of what changed. Old reservoir links in the app and the docs bring you to the right brain or to this page.

What Happened to Your Reservoirs

Each reservoir was migrated once. Running the migration again changes nothing.

  • It became a brain. Each reservoir was mapped to an existing brain, or to a new brain named after it with the same description.
  • Its keywords became a watch. Monitored keywords, platforms and subreddits became a keyword watch on that brain. Keywords you had switched off came across as a watch that is turned off.
  • Your curated items came with it. Items you bookmarked, or that fed a draft, became ordinary notes in the brain.
  • Everything else was archived, not deleted. Unread discovery results were archived. They can be restored.
  • Captures go to Triage. Inbound email, Idea Inbox routing, browser extension capture and "add to brain" from monitoring now land in the Triage lane of the mapped brain.
  • The record of which brain each reservoir became is kept. That is what lets old reservoir links find their brain now that the reservoir data itself is gone.

Where Things Live Now

You used toNow you
Open Reservoirs in the sidebarOpen Brain in the sidebar and pick a brain
Set monitored keywords on a reservoirAdd a watch on the brain's Watch tab (Brain Watches)
Send email to a reservoir's addressSend it to the same address. It now belongs to the brain, on its Email tab (Email Addresses)
Review new reservoir itemsPromote or dismiss them on the brain's Triage tab
Send a link or transcript into a reservoirSend it to a brain with post_brain_ingest (Brain Ingest)
Extract a video transcript on a reservoir itemTranscribe it with transcribe_video, then send the text to a brain with post_brain_ingest
Call the reservoir API or the reservoir MCP toolsUse the brain tools below. Tables and tools removed: the reservoir API routes, six reservoir MCP tools and the reservoir tables are gone. Old /admin/reservoirs links still open the right brain

For a full walkthrough, read Keep a Brain Current.

Chat and the Post Editor

Chat no longer reads from a reservoir linked to the post. It looks across all of your site's brains and picks the notes that match your question. Only approved notes are used. Items still waiting in Triage, and items you dismissed, never reach an answer. The notes chat drew on are counted under the answer as Context Sources. Click the count to see which notes they were.

The post editor's Reservoir card is gone. There is nothing to link: every post gets the same brain context.

In Operator Chat, ask "what brains do I have?" to list them.

Tool Replacements

Six reservoir MCP tools have been removed. post_reservoir_ingest is the only one left, and it is deprecated. Use the replacement for each.

Old toolUse instead
post_reservoir_ingest (deprecated)post_brain_ingest
list_reservoirs (removed)list_brains
get_reservoir (removed)get_brain
list_reservoir_items (removed)list_notes with brain_id, or list_triage for unreviewed items
get_reservoir_item (removed)get_note
patch_reservoir_item (removed)patch_notes
delete_reservoir_item (removed)delete_notes, or dismiss_triage_item for an unreviewed item

post_reservoir_ingest is a thin layer over brain ingest. With a brain_id it writes to that brain. With a reservoir_id it writes to the brain that reservoir became. A reservoir that never became a brain is refused, because reservoirs no longer accept items. delete_notes has no times_referenced guard, so check a note's times_referenced before deleting it.

Related

Want this page as machine-readable markdown? GET /docs/features/reservoirs-to-brains.md