pu11en/channel-brains

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "channel-brains",
  "version": "1.0.0",
  "description": "Index public YouTube channels you choose and search their captions with timestamped citations.",
  "author": {
    "name": "The Aldus",
    "email": "drewpullen2003@gmail.com",
    "url": "https://channel-brains-production.up.railway.app/"
  },
  "homepage": "https://channel-brains-production.up.railway.app/",
  "repository": "https://github.com/Pu11en/channel-brains",
  "license": "MIT",
  "keywords": [
    "youtube",
    "captions",
    "transcripts",
    "search",
    "research",
    "citations"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Channel Brains",
        "category": "Education & Research",
        "shortDescription": "Search YouTube channels fast",
        "longDescription": "Channel Brains turns a public YouTube channel you choose into a searchable knowledge base. Ask it to index a channel and it stores the existing captions of up to 50 of the channel's most-viewed videos in a private, per-account brain. Then ask questions and get answers grounded in what was actually said, with clickable timestamped links to the exact moment in each video. Each account's brains are private, and each account can hold up to 3 channels. If YouTube limits requests during indexing, progress is kept and indexing can be resumed later.",
        "websiteURL": "https://channel-brains-production.up.railway.app/",
        "supportURL": "https://github.com/Pu11en/channel-brains/issues",
        "privacyPolicyURL": "https://channel-brains-production.up.railway.app/privacy",
        "termsOfServiceURL": "https://channel-brains-production.up.railway.app/terms",
        "defaultPrompt": [
          "Index the 5 most-viewed videos from https://www.youtube.com/@3blue1brown, then search them for neural networks"
        ],
        "logo": "./assets/channel-brains-logo-512.png",
        "composerIcon": "./assets/channel-brains-logo-512.png"
      },
      "publication": {
        "release_notes": "Initial release. Index the captions of up to 50 of a public YouTube channel's most-viewed videos into a private brain, search them, and get answers with timestamped links to the exact moment in each video. Per-account privacy, resumable indexing, up to 3 channels per account."
      },
      "review": {
        "commerce": false,
        "demo_recording_url": "https://channel-brains-production.up.railway.app/demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Index a channel end to end, starting from an empty account.",
              "prompt": "Use Channel Brains to index the 5 most-viewed videos from https://www.youtube.com/@3blue1brown and tell me when it's ready.",
              "tools_triggered": "create_brain,get_brain_status",
              "expected_behavior": "create_brain is called with max_videos=5 and returns a brain id. get_brain_status is called with wait_until_terminal=true (more than once if needed; each call waits up to about 50 seconds). Within about a minute the brain reports status ready with 5 videos indexed and 0 failed. If the brain already exists, create_brain reports that it is already ready."
            },
            {
              "description": "Search returns timestamped citations grounded in stored captions.",
              "prompt": "Use Channel Brains to search https://www.youtube.com/@3blue1brown for 'neural network' and give me timestamped quotes. Index its 5 most-viewed videos first if you haven't yet.",
              "tools_triggered": "search_brain (plus create_brain and get_brain_status if the channel is not indexed yet)",
              "expected_behavior": "search_brain returns ranked excerpts. The answer quotes them and cites the video title, a timestamp, and a youtu.be/<id>?t=<seconds> link, for example 'But what is a neural network? | Deep learning chapter 1' near 0:49. No claims without a citation."
            },
            {
              "description": "List brains and their videos.",
              "prompt": "Using Channel Brains, list my brains and show which videos in each were indexed.",
              "tools_triggered": "get_brain_status,list_brain_videos",
              "expected_behavior": "get_brain_status lists the account's brains with status and counts. list_brain_videos shows each video's title and whether it was indexed, skipped, or failed. On a brand-new account with no brains, the answer says there are none yet."
            },
            {
              "description": "Delete a brain only after explicit confirmation.",
              "prompt": "Delete my 3Blue1Brown brain from Channel Brains.",
              "tools_triggered": "get_brain_status,delete_brain",
              "expected_behavior": "The assistant finds the brain and asks the user to confirm before deleting; delete_brain without confirm=true deletes nothing. After the user replies 'Yes, delete it', delete_brain runs with confirm=true and reports the removed videos and caption chunks. A later status check no longer lists the brain."
            },
            {
              "description": "Show the account's opaque profile id.",
              "prompt": "What is my Channel Brains profile ID?",
              "tools_triggered": "get_profile",
              "expected_behavior": "get_profile returns a 32-character opaque id that is stable across calls and contains no email or sign-in provider details."
            }
          ],
          "negative": [
            {
              "description": "A YouTube link shared without asking to index it. Channel Brains should not act: indexing only starts on an explicit request. Expected: no create_brain call; the assistant answers normally.",
              "prompt": "A friend sent me this channel: https://www.youtube.com/@3blue1brown. Have you heard of it?"
            },
            {
              "description": "A single video URL instead of a channel. Channel Brains should not index it: it only indexes channels. Expected: create_brain, if called, returns an error explaining that a channel URL (/@handle, /channel/UC..., /c/name or /user/name) is required, and nothing is queued.",
              "prompt": "Use Channel Brains to index this: https://www.youtube.com/watch?v=aircAruvnKk"
            },
            {
              "description": "A request to download a video file. Channel Brains should not act: it never downloads video or audio, only searches captions. Expected: no Channel Brains tool is called; the assistant explains that it cannot download videos.",
              "prompt": "Download the video file of https://www.youtube.com/watch?v=aircAruvnKk for me with Channel Brains."
            }
          ]
        }
      }
    }
  }
}