🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί BibiGPT Skill
πŸ¦€ ClawHub

BibiGPT Skill

by @jimmylv

BibiGPT CLI for summarizing videos, audio, and podcasts directly in the terminal. Use when the user wants to summarize a URL (YouTube, Bilibili, podcast, etc...

Versionv1.0.0
Downloads2,781
Installs8
Stars⭐ 3
Comments1
#video#audio#legal
TERMINAL
clawhub install bibigpt-skill

πŸ“– About This Skill

name: bibi description: > BibiGPT CLI for summarizing videos, audio, and podcasts directly in the terminal. Use when the user wants to summarize a URL (YouTube, Bilibili, podcast, etc.) or check their BibiGPT authentication status. Requires the BibiGPT desktop app installed with an active login session, or a BIBI_API_TOKEN environment variable set.

BibiGPT CLI (bibi)

Summarize videos, audio, and podcasts from the terminal using the BibiGPT API.

Installation

macOS (Homebrew)

brew install --cask jimmylv/bibigpt/bibigpt

Windows

Download the installer from: https://bibigpt.co/download/desktop

winget install BibiGPT --source winget

Verify installation

bibi --version

Authentication

After installing, the user must log in via the desktop app at least once. The CLI reads the saved session automatically from the desktop app's settings.

Alternatively, set an API token: 

export BIBI_API_TOKEN=

On Windows (PowerShell): 

$env:BIBI_API_TOKEN=""

Commands

Summarize a URL

Important: URLs containing ? or & must be quoted to avoid shell glob errors.

# Basic summary (Markdown output to stdout)
bibi summarize ""
Async mode β€” recommended for long videos (>30min)

bibi summarize "" --async
Chapter-by-chapter summary

bibi summarize "" --chapter
Fetch subtitles/transcript only (no AI summary)

bibi summarize "" --subtitle
Full JSON response

bibi summarize "" --json
Combine flags

bibi summarize "" --subtitle --json

Supported URL types: YouTube, Bilibili, podcasts, audio files, and any URL supported by BibiGPT.

Authentication

# Check current auth status
bibi auth check
Open browser to log in

bibi auth login
Show how to set API token

bibi auth set-token

Updates

# Check if a new version is available
bibi check-update
Download and install the latest version

bibi self-update

Output Format

  • Default: Markdown summary text sent to stdout. Progress info goes to stderr.
  • --json: Complete API response as pretty-printed JSON to stdout.

    • This means you can pipe the output: 

    bibi summarize "" > summary.md
bibi summarize "" --json | jq '.summary'

    Error Handling

    | Exit Code | Meaning | |-----------|---------| | 0 | Success | | 1 | Error (auth missing, API error, timeout, etc.) |

    | HTTP Status | User Action | |-------------|-------------| | 401 | Token expired β€” run bibi auth login or re-login in desktop app | | 402/403 | Quota exceeded β€” visit https://bibigpt.co/pricing | | 429 | Rate limited β€” wait and retry |

    Usage Tips

  • For very long videos, use --async to avoid HTTP timeout.
  • Use --subtitle to get raw subtitles/transcript without AI summarization.
  • Use --json when you need structured data (e.g., sourceUrl, htmlUrl, detail).
  • The --chapter flag provides section-by-section summaries, useful for lectures or tutorials.
  • The CLI does NOT open any GUI window β€” all output goes to the terminal.
  • Run bibi check-update periodically to get new features and bug fixes.