{
  "markdown": "# bibigpt-skill\n\nAI Agent skill for summarizing videos, audio, and podcasts via [BibiGPT](https://bibigpt.co).\n\nHand-held per-host install pages: [bibigpt.co/agent](https://bibigpt.co/agent) (ChatGPT, Claude Code, OpenClaw, WorkBuddy, Doubao Work, QwenWork, DeepSeek Harness).\n\nFour ways to use:\n1. **BibiGPT Desktop + CLI Skill** — install `bibi` CLI, works with Claude Code / OpenClaw / Codex / WorkBuddy / QwenWork / Doubao Work / DeepSeek Harness\n2. **Remote MCP Server** — zero install, works with any MCP client (Claude, ChatGPT, Cursor, etc.)\n3. **OpenAPI** — direct HTTP calls for containers, CI, or custom integrations\n4. **Codex Plugin** — this repo doubles as a Codex plugin (`.codex-plugin/` manifest + MCP + skills)\n\n### Install as a Codex plugin\n\nFrom the terminal:\n\n```bash\ncodex plugin marketplace add JimmyLv/bibigpt-skill\ncodex plugin add bibi@bibigpt\n```\n\nOr inside a Codex session: `/plugin marketplace add JimmyLv/bibigpt-skill`,\nthen install `bibi` from the marketplace tab in `/plugins`. Also works in the\nCodex IDE extension (Settings → Plugins) and the ChatGPT desktop app\n(Work / Codex). Authentication happens on first use via OAuth — no API keys\nto manage.\n\n---\n\n## Skill Structure\n\n```\nskills/bibi/\n├── SKILL.md                        # Intent router — dispatches to workflows\n├── scripts/\n│   └── bibi-check.sh              # Auto-detect CLI vs API mode\n├── references/\n│   ├── cli.md                     # CLI command reference\n│   ├── api.md                     # OpenAPI endpoint reference (10 endpoints)\n│   ├── installation.md            # Setup & auth guide\n│   └── supported-platforms.md     # URL types & platform limits\n└── workflows/\n    ├── quick-summary.md           # Paste URL → get AI summary\n    ├── deep-dive.md               # Chapter breakdown + follow-up Q&A\n    ├── transcript-extract.md      # Subtitle/transcript extraction\n    ├── article-rewrite.md         # Video → blog/公众号图文/小红书\n    ├── batch-process.md           # Multi-URL batch processing\n    ├── research-compile.md        # Multi-source topic synthesis\n    ├── export-notes.md            # Save to Notion/Obsidian/local\n    └── visual-analysis.md         # Video frame visual analysis\n```\n\n## Workflows\n\n| Workflow | What it does | Trigger examples |\n|----------|-------------|-----------------|\n| **Quick Summary** | One URL → AI summary | \"summarize this video\", \"总结\" |\n| **Deep Dive** | Chapter-by-chapter + Q&A | \"chapter summary\", \"分章节总结\" |\n| **Transcript Extract** | Raw subtitles with timestamps | \"get subtitles\", \"获取字幕\" |\n| **Article Rewrite** | Video → polished article | \"turn into article\", \"AI改写\" |\n| **Batch Process** | Multiple URLs at once | \"batch summarize\", \"批量总结\" |\n| **Research Compile** | Cross-source synthesis | \"compare these videos\", \"综合分析\" |\n| **Export Notes** | Save to Notion/Obsidian/file | \"save to Notion\", \"导出笔记\" |\n| **Visual Analysis** | Analyze slides & on-screen content | \"画面分析\", \"what's on screen\" |\n\n---\n\n## Quick Start\n\n### 1. Install Desktop App\n\n```bash\ncurl -fsSL https://bibigpt.co/install.sh | bash\n```\n\nWorks on **macOS** (auto-uses Homebrew), **Linux** (downloads AppImage), and detects Windows (prompts to use winget).\n\nOr install manually per platform:\n- **macOS**: `brew install --cask jimmylv/bibigpt/bibigpt` ([Homebrew tap](https://github.com/JimmyLv/homebrew-bibigpt))\n- **Windows**: `winget install BibiGPT --source winget` or download from [bibigpt.co/download/desktop](https://bibigpt.co/download/desktop)\n- **Linux**: Download `.deb` / `.AppImage` from [bibigpt.co/download/desktop](https://bibigpt.co/download/desktop)\n\nThen log in: `bibi auth login` (opens browser for OAuth, saves token automatically).\n\n### 2. Install Skill\n\n#### Claude Code\n\n```bash\nnpx skills add JimmyLv/bibigpt-skill\n```\n\n#### OpenClaw\n\n```bash\nnpx skills add JimmyLv/bibigpt-skill --agents OpenClaw --yes\n```\n\n#### DeepSeek Harness\n\n```bash\ndsh plugin --profile web add \"github:JimmyLv/bibigpt-skill#path:/dsh-plugin\"\n```\n\nRestart the profile and `/bibi` shows up under **Skills**. Keep the quotes —\n`#` starts a shell comment. Source and the disk-copy alternative live in\n[`dsh-plugin/`](./dsh-plugin). Copying `skills/bibi` into `~/.agents/skills/bibi`\nalso works (shared with Claude Code).\n\n#### WorkBuddy (Tencent)\n\nDownload: [workbuddy.cn](https://www.workbuddy.cn/). Skills live in\n`~/.workbuddy/skills/<name>/SKILL.md`.\n\n```bash\nnpx skills add JimmyLv/bibigpt-skill -g -y\n```\n\nWorkBuddy custom skills need `agent_created: true` in the SKILL.md frontmatter\n(this repo includes it). Then `/reload-skills` or restart the app.\n\nFallback: copy `skills/bibi` to `~/.workbuddy/skills/bibi`.\n\nStep-by-step: https://bibigpt.co/agent/workbuddy\n\n#### 豆包工作 / Doubao Work\n\nDownload desktop: [doubao.com/download/desktop](https://www.doubao.com/download/desktop).\nDoubao Work does **not** publish a filesystem skill directory — do not invent\n`~/.doubao/skills`.\n\nIn the desktop sidebar open **技能 · 连接器 · 伙伴**, create a skill named `bibi`,\nand paste\n[skills/bibi/SKILL.md](https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/SKILL.md).\n\nStep-by-step: https://bibigpt.co/agent/doubao\n\n#### 千问工作 / QwenWork\n\nApp: [qwenwork.cn](https://qwenwork.cn/). Skill dir: `~/.qwenworkcn/skills/`.\nPaste this into QwenWork:\n\n```text\nPlease download https://github.com/JimmyLv/bibigpt-skill and copy skills/bibi to ~/.qwenworkcn/skills/bibi\n```\n\nQwenWork clones and loads the skill from chat. Docs:\nhttps://help.aliyun.com/zh/qwenwork/skills\n\nStep-by-step: https://bibigpt.co/agent/qwenwork\n\n### 3. Usage\n\nAsk your agent to summarize any video, audio URL, or **local file**:\n\n```\n> Summarize this video: https://www.youtube.com/watch?v=xxxxx\n> Summarize this local file: /path/to/meeting-recording.mp4\n```\n\nThe agent will automatically detect the best mode and route to the right workflow.\n\n### Commands\n\n| Command | Description |\n|---------|-------------|\n| `bibi summarize \"<URL>\"` | Summarize a video/audio URL |\n| `bibi summarize \"/path/to/file.mp4\"` | Summarize a local audio/video file |\n| `bibi summarize \"<INPUT>\" --async` | Async mode (long videos) |\n| `bibi summarize \"<INPUT>\" --chapter` | Chapter-by-chapter summary |\n| `bibi summarize \"<INPUT>\" --subtitle` | Fetch subtitles/transcript only |\n| `bibi summarize \"<INPUT>\" --json` | Full JSON output |\n| `bibi auth check` | Check auth status |\n| `bibi auth login` | OAuth login via browser (saves token automatically) |\n| `bibi check-update` | Check for new version |\n| `bibi upgrade` | Download and install latest version (alias: `self-update`) |\n\n---\n\n### Updating\n\nBibiGPT ships **three independently updateable layers**. Pick the one that matches what you want refreshed.\n\n| Layer | Updates | Command | When to run |\n|---|---|---|---|\n| **Skill content** (workflows, references, intent router) | npm-distributed, manual | `npx skills update JimmyLv/bibigpt-skill` | Weekly, or when changelog adds a new MCP tool / workflow |\n| **`bibi` desktop CLI** (binary + embedded SKILL.md + manifest dispatcher) | Self-update or package manager | `bibi upgrade` *(or `brew upgrade --cask bibigpt` / `winget upgrade BibiGPT`)* | When the changelog mentions CLI changes |\n| **Remote MCP server** (`https://bibigpt.co/api/mcp`) | Always latest, server-side | *automatic* — restart your MCP client to pick up new tools | Never manually; happens server-side |\n\n#### Update the skill\n\n```bash\nnpx skills update JimmyLv/bibigpt-skill\n```\n\nThe skill **does not auto-update** — Agents read whatever was last fetched. Re-run when you want new BibiGPT capabilities, fixed workflows, or new MCP tools surfaced. For a clean reinstall:\n\n```bash\nnpx skills remove JimmyLv/bibigpt-skill && npx skills add JimmyLv/bibigpt-skill\n```\n\nThe [GitHub Releases page](https://github.com/JimmyLv/bibigpt-skill/releases) tracks what each version changed.\n\n#### Update the bibi CLI\n\n```bash\nbibi check-update    # peek at the latest published version\nbibi upgrade         # download and install (uses brew on macOS, installer on Windows)\n```\n\nOr via package manager: `brew upgrade --cask bibigpt` / `winget upgrade BibiGPT --source winget` / fresh download from [bibigpt.co/download/desktop](https://bibigpt.co/download/desktop).\n\n> **Manifest is hot-cached, not embedded.** Even without `bibi upgrade`, the CLI dispatcher fetches `https://bibigpt.co/api/cli-manifest.json` on first call (24h TTL) — newly-released agent procedures show up the next day. `bibi upgrade` only matters when the dispatcher itself or the embedded `SKILL.md` changes.\n\n#### Update the MCP server\n\nNothing to do — the remote MCP endpoint always serves the latest `meta.mcp.enabled` tool list. **Restart your MCP client** (Claude Desktop, Cursor, etc.) if you don't see a newly-released tool — that refreshes its `tools/list` cache.\n\n> **Note**: The desktop app build is triggered via the `build-tauri-desktop-app` GitHub Actions workflow. After a successful build, artifacts are uploaded to OSS and the `latest.json` manifest is updated automatically — the client checks this manifest for update availability.\n\n---\n\n## Remote MCP Server (No Install Required)\n\nBibiGPT also provides a remote MCP server at `https://bibigpt.co/api/mcp` — works with any MCP-compatible client. Streamable HTTP transport with OAuth 2.1 authentication.\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `summarize_video` | Summarize a video or podcast URL |\n| `summarize_video_with_config` | Summarize with custom prompt, model, language |\n| `summarize_by_chapter` | Chapter-by-chapter summary |\n| `get_subtitle` | Get transcript/subtitles with timestamps |\n| `create_summary_task` | Create async task for long videos |\n| `get_task_status` | Check async task status |\n\n### Claude Code\n\nAdd to `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"bibigpt\": {\n      \"type\": \"http\",\n      \"url\": \"https://bibigpt.co/api/mcp\"\n    }\n  }\n}\n```\n\nOr via CLI:\n\n```bash\nclaude mcp add --transport http bibigpt https://bibigpt.co/api/mcp\n```\n\n### OpenAI Codex\n\nEdit `~/.codex/config.toml` (or `.codex/config.toml` in project root):\n\n```toml\n[mcp_servers.bibigpt]\nurl = \"https://bibigpt.co/api/mcp\"\n```\n\nWith API key authentication:\n\n```toml\n[mcp_servers.bibigpt]\nurl = \"https://bibigpt.co/api/mcp\"\nbearer_token_env_var = \"BIBIGPT_API_KEY\"\n```\n\n### Claude Desktop\n\n**Option A** — UI (recommended): Settings → Connectors → Add Connector → paste `https://bibigpt.co/api/mcp`\n\n**Option B** — Config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"bibigpt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://bibigpt.co/api/mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in project root, or configure in Cursor Settings → MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"bibigpt\": {\n      \"url\": \"https://bibigpt.co/api/mcp\",\n      \"type\": \"streamable-http\"\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\nAdd `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"bibigpt\": {\n      \"type\": \"http\",\n      \"url\": \"https://bibigpt.co/api/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bibigpt\": {\n      \"serverUrl\": \"https://bibigpt.co/api/mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT\n\n1. Settings → Apps & Connectors → Advanced settings → enable **Developer mode**\n2. Settings → Apps & Connectors → **Create** connector\n3. Enter URL: `https://bibigpt.co/api/mcp`\n4. Complete OAuth authorization when prompted\n\n### Manus\n\nSettings → Connectors → Add Connectors → Custom MCP → +Add Custom MCP:\n\nEnter server URL: `https://bibigpt.co/api/mcp`\n\n### LobeChat\n\nSettings → Plugin Settings → Custom Plugins → Quick Import JSON:\n\n```json\n{\n  \"type\": \"mcp:streamable-http\",\n  \"url\": \"https://bibigpt.co/api/mcp\",\n  \"metadata\": {\n    \"title\": \"BibiGPT\",\n    \"description\": \"AI Video & Audio Summarizer\"\n  }\n}\n```\n\n### Direct API Key (Skip OAuth)\n\nIf you have a BibiGPT API key, skip OAuth and use Bearer token directly:\n\n```bash\n# List available tools (no auth needed for discovery)\ncurl -X POST https://bibigpt.co/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n\n# Summarize a video (requires auth)\ncurl -X POST https://bibigpt.co/api/mcp \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"summarize_video\",\"arguments\":{\"url\":\"https://www.youtube.com/watch?v=xxxxx\"}}}'\n```\n\nGet your API key at [bibigpt.co/user/integration](https://bibigpt.co/user/integration).\n\n## License\n\nMIT\n",
  "bytes": 12802,
  "sha": "04dc9c46e60eeff9b2e1dd90ce36541078a3a6c69c2a8d614fa692f0c3ef7188",
  "repo_slug": "jimmylv/bibigpt-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_jimmylv_bibigpt_skill_bibi_9fc9373b/readme"
}