Agent skill · magnus919
peertube
Browse PeerTube federated video from the terminal: view videos and channels,
What it needs
About 3k tokens when loaded.
What this skill does
peertube-cli — PeerTube Federated Video Browse videos, channels, and server info on any PeerTube instance. Search across the fediverse, list channels, check your account stats, and manage authentication — all from the terminal. Setup 1. Set the PeerTube instance URL: 2. (Optional) Log in for authenticated operations: The OAuth2 token is persisted to ~/.config/peertube-cli/token.json and automatically reused. --dry-run works without authentication. Essential Commands auth login — Authenticate to a PeerTube instance Token is saved to ~/.config/peertube-cli/token.json and reused on subsequent calls. Tokens expire after the server-configured lifetime (typically 24h). server — Instance information Shows: instance name, short description, total users, total videos, total views. videos — Browse recent videos Shows: title, duration, views, author/channel, publish date. search — Search videos across the fediverse channels — List video channels Shows: display name, channel handle (@name), video count, subscriber count. me — Your profile Shows: username, role, video count, view count. Requires authentication. Global Flags All flags work in any position: Known Gotchas Set PEERTUBESERVER first — Without this env var, the CLI defaults to https://your-instance.example.com (which won't resolve). Always export the correct instance URL. Authentication is required for most commands — server and public video browsing work without auth. me, channels, and personal video lists require a valid OAuth token. Use --dry-run to preview without auth. Token is persisted automatically — After auth login, the token is saved to ~/.config/peertube-cli/token.json. No need to login again unless the token expires. Delete this file to force re-login. Token expiry — PeerTube OAuth2 tokens have a configurable expiry (default ~24h). Expired tokens cause 401 errors. Re-run auth login to refresh. Cross-instance search — search --query searches across the fediverse, not just the local instance. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/peertube