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 Today

See 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!