Releases: zavocc/youtube-cli
Release list
0.0.20260703-alpha
This version includes youtube-search-cli update.
Add --compact CLI argument for search, channel, and playlist subcommands. This still outputs most information but without indentation and excludes thumbnails, etags, and other unnecessary fields.
Useful for agents where context window size and cost constraints matter.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-search-cli-darwin-arm64-alpha - For Linux users with intel 64-bit processors, use:
youtube-search-cli-linux-amd64-alpha - For Windows with intel 64-bit processors, use:
youtube-search-cli-windows-amd64-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli and youtube-search-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260702-alpha
This version includes youtube-watcher-cli update.
Add the ability to use models with Gemini Enterprise Agent Platform (a.k.a Vertex AI) instead of Google AI studio API. Instead of setting GEMINI_API_KEY to authenticate, variables GOOGLE_GENAI_USE_ENTERPRISE and GOOGLE_CLOUD_PROJECT must be set, with using global region by default unless GOOGLE_CLOUD_LOCATION is explicitly set, authentication can almost be set with anything as per https://docs.cloud.google.com/docs/authentication.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-watcher-cli-darwin-arm64-alpha - For Linux users with intel 64-bit processors, use:
youtube-watcher-cli-linux-amd64-alpha - For Windows with intel 64-bit processors, use:
youtube-watcher-cli-windows-amd64-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli and youtube-search-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260628-alpha-rev0
remove confidence field in response due to hallucinations
0.0.20260627-alpha
This version updates both youtube-watcher-cli and youtube-search-cli and is sync.
Changes in YouTube Watcher CLI:
- Its AI response now outputs in JSON string with a defined schema for predictability of its outputs.
Changes in YouTube Search CLI:
- Added new
channelfilter type insearch --filtersubcommand flag.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-*-cli-darwin-arm64-0.0.20260627-alpha. - For Linux users with intel 64-bit processors, use:
youtube-*-cli-linux-amd64-0.0.20260627-alpha - For Windows with intel 64-bit processors, use:
youtube-*-cli-windows-amd64-0.0.20260627-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli and youtube-search-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260626-alpha
This version updates both youtube-watcher-cli and youtube-search-cli and is sync.
Changes in YouTube Watcher CLI:
- Fix media resolution setting where
gemini-2.5-flashfails because per-part media resolution isn't supported which was used, therefore the fix was to change it to global media resolution inGenerateContentConfig - Updated system prompt to reduce markdown formatting syntax tics and follow ups, as well as less likely to remind about putting arguments after the prompt as it tends to remind even if there's no such token.
Changes in YouTube Search CLI:
- Added new
channelsubcommand, lists videos from specified YouTube channel. This costs two units for listing channel and listing videos from channel with playlist endpoint.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-*-cli-darwin-arm64-0.0.20260626-alpha. - For Linux users with intel 64-bit processors, use:
youtube-*-cli-linux-amd64-0.0.20260626-alpha - For Windows with intel 64-bit processors, use:
youtube-*-cli-windows-amd64-0.0.20260626-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli and youtube-search-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260624-alpha
This version includes a new CLI tool: youtube-search-cli, designed to connect and search YouTube videos directly from YouTube Data API for your own terminal or personal agents that you use.
To get started, download and install the executables below then enable YouTube Data API and grab a restricted API Key for free from credentials page for YouTube Data API. Create a new credential that is API Key and not OAuth 2.0 auth.
After obtaining the API key, you can set the environment variable YOUTUBE_DATA_API_KEY= with your API Key. You can also set the environment variable directly from ~/.youtube.env
Start searching:
youtube-search-cli search Latest News TodaySee youtube-search-cli --help for more information how to use this program.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-search-cli-darwin-arm64-0.0.20260624-alpha. - For Linux users with intel 64-bit processors, use:
youtube-search-cli-linux-amd64-0.0.20260624-alpha - For Windows with intel 64-bit processors, use:
youtube-search-cli-windows-amd64-0.0.20260624-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli and youtube-search-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260623-alpha
Adds a new optional --media-resolution parameter, accepts both low (default) or high resolution. --id mandatory argument now changed to --video which now accepts both full YouTube video URLs and video ID. You must update the agent skill for the agent to reflect the change.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based on the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-watcher-cli-darwin-arm64-0.0.20260623-alpha. - For Linux users with intel 64-bit processors, use:
youtube-watcher-cli-linux-amd64-0.0.20260623-alpha - For Windows with intel 64-bit processors, use:
youtube-watcher-cli-windows-amd64-0.0.20260623-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260619-alpha
Adds a new optional --model parameter. This snapshot only supports Gemini 2.5 Flash, Gemini 3 Flash Preview, and Gemini 3.1 Flash Lite with fixed reasoning levels for each models, optimized for performance and cost. If --model isn't specified, it will use 2.5 Flash by default.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based from the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-watcher-cli-darwin-arm64-0.0.20260619-alpha. - For Linux users with intel 64-bit processors, use:
youtube-watcher-cli-linux-amd64-0.0.20260619-alpha - For Windows with intel 64-bit processors, use:
youtube-watcher-cli-windows-amd64-0.0.20260619-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!
0.0.20260618-alpha
This is the first ever alpha release snapshot.
It only includes basic functionality for now as of this snapshot, as well as a copy of youtube-watcher-cli\SKILL.md agent skill where you can use for the coding or personal agents of your choice to guide the LLM on how to use this program.
To get started, simply pass --id [YOUTUBE_VIDEO_ID] along with the prompt at the end, and it will generate a response in stdout, any errors will be outputted in stderr.
Note that you must specify the --id, --help, or --version parameters first before the prompt and not the other way around. Gemini API key from Google AI Studio is required and must set GEMINI_API_KEY variable either from your current session environment where environment variables are sourced and loaded or from the file $HOME/.youtube.env with GEMINI_API_KEY= set. Get your API key for free.
Please check README.md on how to get started as well as missing features that will be planned for next release. Keep in mind that because this is a pre-release tool that isn't tied to specific version yet, some documentation may be incomplete.
How to install
Download the binaries based from the respective OS you're using.
- [UNTESTED] For macOS users with M-series processors, use:
youtube-watcher-cli-darwin-arm64-0.0.20260618-alpha. - For Linux users with intel 64-bit processors, use:
youtube-watcher-cli-linux-amd64-0.0.20260618-alpha - For Windows with intel 64-bit processors, use:
youtube-watcher-cli-windows-amd64-0.0.20260618-alpha.exe
To ensure coding agents, applications, and command line processors can execute this command, install these binaries to directories that is registered on the PATH environment variable and the executable name can be simplified as youtube-watcher-cli for easy access.
Disclaimers
Because this is a pre-release tool: name, functionality, documentation, and program behaviors can be changed at anytime. Use this at your own risk!