Agent Video

beta

Upload and manage videos from the terminal or from a coding agent — chunked resumable uploads, chapters, privacy tiers, and a stdio MCP server, backed by the self-hosted Agent Video server.

Author: Poul Kjeldager
Usage: agent-video <command> [options]
Platform: linuxmacoswindows
Category: agents

Examples

$ agent-video login

Sign in via browser (OIDC loopback)

$ agent-video upload session.mp4 --title "Sprint demo"

Chunked resumable upload with a title

$ agent-video list

List your videos

$ agent-video install

Wire ./.mcp.json so an agent can upload with no shell access

Overview

agent-video is the standalone Go CLI for Agent Video — a self-hosted video-sharing product at video.agentics.dk. It logs you in over OIDC, uploads local video files with a chunked resumable protocol, manages a video's title/description/privacy/chapters, mints machine bearer tokens for CI/agent use, and runs a local stdio MCP server so a coding agent can publish a video directly — no shell access, no browser.

What you get

  • Chunked, resumable uploads. Files are sent in 8 MiB chunks over io.Reader/io.SectionReader — the whole file is never buffered in memory. If an upload is interrupted, re-running the same command resumes from the last chunk the server actually received.
  • Privacy tiers. public, unlisted (default), password, and private, set at upload time or later with edit.
  • Chapters. Replace a video's whole chapter list from a JSON file, or append one chapter at a time with a MM:SS=Title shorthand.
  • Machine tokens. token mint issues a bearer token for CI or an agent that can't run an interactive browser login; AGENT_VIDEO_TOKEN picks it up automatically and skips OIDC entirely.
  • A stdio MCP server (agent-video mcp) exposing upload, list, and show as tools, so an agent can publish a video as a normal tool call.

Subcommands

login · upload · video (videos, list, ls) · show · edit · chapters (chapter) · rm (delete, remove) · token (tokens: mint/list/revoke) · mcp · install (install aspire) · version · help

See the CLI reference for every flag and the full env-var table.

Next steps

Defaults

SettingValue
Serverhttps://video.agentics.dk
OIDC issuerhttps://login.agentics.dk/realms/agentics
Client idagentics-video-desktop
Config dir~/.agent-video

Override with AGENT_VIDEO_SERVER, AGENT_VIDEO_ISSUER, AGENT_VIDEO_CLIENT_ID, and AGENT_VIDEO_HOME. See the CLI reference for the full env-var table.