OpenClaw / Claude Code / Codex Agent skill for summarizing videos/audio via BibiGPT CLI (bibi)
$git clone https://github.com/jimmylv/bibigpt-skillInstalls into the current project.
Install bibigpt-skill by running `git clone https://github.com/jimmylv/bibigpt-skill`, then use it for the current task and follow its documentation at https://github.com/jimmylv/bibigpt-skill.
| 1 | # bibigpt-skill |
| 2 | |
| 3 | AI Agent skill for summarizing videos, audio, and podcasts via [BibiGPT](https://bibigpt.co). |
| 4 | |
| 5 | Four ways to use: |
| 6 | 1. **BibiGPT Desktop + CLI Skill** — install `bibi` CLI, works with Claude Code / OpenClaw / Codex |
| 7 | 2. **Remote MCP Server** — zero install, works with any MCP client (Claude, ChatGPT, Cursor, etc.) |
| 8 | 3. **OpenAPI** — direct HTTP calls for containers, CI, or custom integrations |
| 9 | 4. **Codex Plugin** — this repo doubles as a Codex plugin (`.codex-plugin/` manifest + MCP + skills) |
| 10 | |
| 11 | ### Install as a Codex plugin |
| 12 | |
| 13 | From the terminal: |
| 14 | |
| 15 | ```bash |
| 16 | codex plugin marketplace add JimmyLv/bibigpt-skill |
| 17 | codex plugin add bibi@bibigpt |
| 18 | ``` |
| 19 | |
| 20 | Or inside a Codex session: `/plugin marketplace add JimmyLv/bibigpt-skill`, |
| 21 | then install `bibi` from the marketplace tab in `/plugins`. Also works in the |
| 22 | Codex IDE extension (Settings → Plugins) and the ChatGPT desktop app |
| 23 | (Work / Codex). Authentication happens on first use via OAuth — no API keys |
| 24 | to manage. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## Skill Structure |
| 29 | |
| 30 | ``` |
| 31 | skills/bibi/ |
| 32 | ├── SKILL.md # Intent router — dispatches to workflows |
| 33 | ├── scripts/ |
| 34 | │ └── bibi-check.sh # Auto-detect CLI vs API mode |
| 35 | ├── references/ |
| 36 | │ ├── cli.md # CLI command reference |
| 37 | │ ├── api.md # OpenAPI endpoint reference (10 endpoints) |
| 38 | │ ├── installation.md # Setup & auth guide |
| 39 | │ └── supported-platforms.md # URL types & platform limits |
| 40 | └── workflows/ |
| 41 | ├── quick-summary.md # Paste URL → get AI summary |
| 42 | ├── deep-dive.md # Chapter breakdown + follow-up Q&A |
| 43 | ├── transcript-extract.md # Subtitle/transcript extraction |
| 44 | ├── article-rewrite.md # Video → blog/公众号图文/小红书 |
| 45 | ├── batch-process.md # Multi-URL batch processing |
| 46 | ├── research-compile.md # Multi-source topic synthesis |
| 47 | ├── export-notes.md # Save to Notion/Obsidian/local |
| 48 | └── visual-analysis.md # Video frame visual analysis |
| 49 | ``` |
| 50 | |
| 51 | ## Workflows |
| 52 | |
| 53 | | Workflow | What it does | Trigger examples | |
| 54 | |----------|-------------|-----------------| |
| 55 | | **Quick Summary** | One URL → AI summary | "summarize this video", "总结" | |
| 56 | | **Deep Dive** | Chapter-by-chapter + Q&A | "chapter summary", "分章节总结" | |
| 57 | | **Transcript Extract** | Raw subtitles with timestamps | "get subtitles", "获取字幕" | |
| 58 | | **Article Rewrite** | Video → polished article | "turn into article", "AI改写" | |
| 59 | | **Batch Process** | Multiple URLs at once | "batch summarize", "批量总结" | |
| 60 | | **Research Compile** | Cross-source synthesis | "compare these videos", "综合分析" | |
| 61 | | **Export Notes** | Save to Notion/Obsidian/file | "save to Notion", "导出笔记" | |
| 62 | | **Visual Analysis** | Analyze slides & on-screen content | "画面分析", "what's on screen" | |
| 63 | |
| 64 | --- |
| 65 | |
| 66 | ## Quick Start |
| 67 | |
| 68 | ### 1. Install Desktop App |
| 69 | |
| 70 | ```bash |
| 71 | curl -fsSL https://bibigpt.co/install.sh | bash |
| 72 | ``` |
| 73 | |
| 74 | Works on **macOS** (auto-uses Homebrew), **Linux** (downloads AppImage), and detects Windows (prompts to use winget). |
| 75 | |
| 76 | Or install manually per platform: |
| 77 | - **macOS**: `brew install --cask jimmylv/bibigpt/bibigpt` ([Homebrew tap](https://github.com/JimmyLv/homebrew-bibigpt)) |
| 78 | - **Windows**: `winget install BibiGPT --source winget` or download from [bibigpt.co/download/desktop](https://bibigpt.co/download/desktop) |
| 79 | - **Linux**: Download `.deb` / `.AppImage` from [bibigpt.co/download/desktop](https://bibigpt.co/download/desktop) |
| 80 | |
| 81 | Then log in: `bibi auth login` (opens browser for OAuth, saves token automatically). |
| 82 | |
| 83 | ### 2. Install Skill |
| 84 | |
| 85 | #### Claude Code |
| 86 | |
| 87 | ```bash |
| 88 | npx skills add JimmyLv/bibigpt-skill |
| 89 | ``` |
| 90 | |
| 91 | #### OpenClaw |
| 92 | |
| 93 | ```bash |
| 94 | npx skills add JimmyLv/bibigpt-skill --agents OpenClaw --yes |
| 95 | ``` |
| 96 | |
| 97 | ### 3. Usage |
| 98 | |
| 99 | Ask your agent to summarize any video, audio URL, or **local file**: |
| 100 | |
| 101 | ``` |
| 102 | > Summarize this video: https://www.youtube.com/watch?v=xxxxx |
| 103 | > Summarize this local file: /path/to/meeting-recording.mp4 |
| 104 | ``` |
| 105 | |
| 106 | The agent will automatically detect the best mode and route to the right workflow. |
| 107 | |
| 108 | ### Commands |
| 109 | |
| 110 | | Command | Description | |
| 111 | |---------|-------------| |
| 112 | | `bibi summarize "<URL>"` | Summarize a video/audio URL | |
| 113 | | `bibi summarize "/path/to/file.mp4"` | Summarize a local audio/video file | |
| 114 | | `bibi summarize "<INPUT>" --async` | Async mode (long videos) | |
| 115 | | `bibi summarize "<INPUT>" --chapter` | Chapter-by-chapter summary | |
| 116 | | `bibi summarize "<INPUT>" --subtitle` | Fetch subtitles/transcript only | |
| 117 | | `bibi summarize "<INPUT>" --json` | Full JSON output | |
| 118 | | `bibi auth check` | Check auth status | |
| 119 | | `bibi auth login` | OAuth login via browser (saves token automatically) | |
| 120 | | `bibi check-update` | Check for new version | |
| 121 | | `bibi upgrade` | Download and install latest version (alias: `self-update`) | |
| 122 | |
| 123 | --- |
| 124 | |
| 125 | ### Updating |
| 126 | |
| 127 | BibiGPT ships **three independently updateable layers**. Pick the one that matches what you want refreshed. |
| 128 | |
| 129 | | Layer | Updates | Command | When to run | |
| 130 | |---|---|---|---| |
| 131 | | **Skill content** (workflows, references, intent router) | npm-distributed, manual | `npx skills update JimmyLv/bibigpt-skill` | Weekly, or when changelog |