Full-text search over your personal BrainTube knowledge corpus. Searches across YouTube, Instagram, web, LinkedIn, GitHub, Twitter and more. Returns results ranked by recency with taint warnings.

Get full details for a specific saved item including transcript, description, summary, key takeaways and taint level. Pass YouTube video ID or internal UUID.

List your most recently saved items across all source types. Use to resume a research session or review what was captured lately.

Get your personal corpus statistics: total items saved, breakdown by source type (youtube/instagram/web/etc), taint distribution. Call this before searching to understand what knowledge is available.

Find items semantically similar to a given item using vector similarity. Useful for discovering related concepts, follow-up research, or building knowledge clusters. Requires embeddings — run backfill_embeddings first if results are empty.

Search your corpus filtered to a specific source type. Use when you want results only from "youtube", "instagram", "web", "notion", "linkedin", "twitter", "github", "reddit", "pdf", "note", etc. Combines semantic + keyword fallback.

Semantic search scoped to items saved between two dates. Pass ISO 8601 dates for "after" and "before". Useful for reviewing what you captured during a specific period or project.

List saved bookmarks from your corpus. Filter by read/unread status. Returns title, URL, tags, and read state sorted by bookmarked_at desc.

Connect your Readwise account to BrainTube by saving your Readwise API token. Required before sync_readwise can run. Get your token at readwise.io/access_token.

Import highlights from your Readwise library into your BrainTube corpus. Use mode=incremental (default) to fetch only new highlights, or mode=full to re-import everything. Requires connect_readwise first.

Retrieve your most recently saved Claude and ChatGPT conversations. Useful for resuming context from a previous session or reviewing past AI-assisted work.

One-shot session bootstrap: combines expertise profile, last 5 AI conversations, and corpus stats into a single JSON object. Call this at the start of a session to load full context without multiple round-trips.

Surface forgotten items from your corpus using weighted randomness — items you've retrieved least often are most likely to appear. Great for spaced repetition and rediscovering old saves.

Search your local Obsidian vault via the Obsidian Local REST API plugin (exposed through Tailscale). Returns matching notes with title, file path, and a text excerpt. Requires OBSIDIAN_BRIDGE_URL and OBSIDIAN_API_KEY set in Railway env vars.

Ask a question to a public BrainTube Brain (a curated knowledge base built from someone's corpus). Pass the brain_slug (visible in the Brain's URL), your question, and optionally prior chat_history for multi-turn conversations. Returns answer + source citations.

List all Brains you have created. Returns slug, name, description, item count, tier (free/pro), and visibility (public/private). Use the slug with chat_with_brain to query a specific Brain.

Build a knowledge graph around a specific item, showing how it connects to other items in your corpus via knowledge_edges. Returns the center item, connected nodes with metadata, and typed edges with confidence scores. Use depth=1 for direct connections, depth=2-3 for wider neighbourhood exploration.

Run a health check on your knowledge corpus. Returns total items, missing embeddings, missing enrichment, missing tags, orphan items, stale items (90d+), contradictions, overdue reviews, topic gaps, and an overall health score out of 100.

Get a topic-level index of your entire knowledge corpus. Groups items by primary topic and returns item count, synthesis count, average salience, latest save date, and source types per topic — sorted by item count descending. Use to understand which subjects dominate your library.

Query compiled concept articles from your knowledge base. Filter by cluster_id, brain_id, or free-text search against title and body. Returns title, slug, word count, and backlink count per article.

Find tags that frequently appear together across your corpus. Returns pairs sorted by co-occurrence count — useful for discovering implicit topic clusters and knowledge relationships.

Find named entities (people, orgs, tools) that frequently co-appear across your corpus. Returns pairs sorted by co-occurrence count — useful for mapping who/what clusters in your knowledge base.

Detect knowledge gaps in your corpus: thin topics (few items), entities without depth, stale high-value items, topics missing concept articles, and unconnected items with no knowledge edges.

Return the items you retrieve most often, ranked by retrieval_count. Surfaces your highest-utility knowledge — the items you keep coming back to.

Multi-hop knowledge search: runs adaptive_search then traverses the knowledge graph from the top-3 results up to max_hops deep, surfacing semantically connected items that a flat search would miss. Returns direct_results + graph_connected + total_nodes_explored.

Get a retrieval quality dashboard for your corpus over the past N days. Covers search hit rates, zero-result queries, top search terms, and result relevance signals.

Find the shortest path between two items in your knowledge graph. Traverses knowledge_edges up to max_depth hops and returns the ordered list of item IDs and edge types along the path, or "no path found" if disconnected.

Get the temporal history of knowledge edges between two specific items — when they were connected, edge types over time, confidence changes. Pass item_a and item_b as UUIDs.