Gemini CLI Video Analysis

A simple, practical tool and Hermes skill for analyzing local video files using the Gemini CLI. It correctly handles common pitfalls with multimodal file injection, ensuring reliable video processing.

Requirements

• A working gemini CLI installation
• A Gemini CLI authentication/configuration flow that already works on your machine
• A local video file such as .mp4, .mov, or .webm

Why this exists

When using the Gemini CLI for video analysis, there are a few common stumbling blocks:

1. Syntax: You must use the strict @{...} syntax (for example @{./video.mp4}), not a bare @path.
2. Workspace constraints: If a video is outside the current workspace, Gemini CLI may refuse to read it.
3. Ignored/temp paths: Gemini CLI can skip multimodal files in .gitignored or temporary directories.

This repository provides:

• a reusable SKILL.md for Hermes-style agent workflows
• a small gemini-video-analyze.sh helper that copies the video to a clean workspace before analysis

Usage

If an agent already has access to the video context, a simple natural-language prompt is often enough:

Review the pacing and storytelling of the video I sent you.

Run the helper script directly when you want to provide a local file path yourself:

./scripts/gemini-video-analyze.sh /path/to/video.mp4

Provide a custom prompt:

./scripts/gemini-video-analyze.sh /path/to/video.mp4 "Review the pacing and storytelling of the video I sent you."

Display help and configuration options:

./scripts/gemini-video-analyze.sh --help

Configuration

The script behavior can be customized via environment variables:

Variable	Default	Description
GEMINI_ENV_FILE	~/.gemini/.env	Path to an environment file to source before running.
GEMINI_VIDEO_WORKSPACE	~/.gemini/video-analysis-workspace	Clean directory where videos are copied for analysis.
GEMINI_APPROVAL_MODE	yolo	Approval mode passed to Gemini CLI (--approval-mode).
GEMINI_OUTPUT_FORMAT	text	Output format passed to Gemini CLI (--output-format).

Installation

You can use this repository as a standalone set of scripts, or install it as a local skill for Hermes.

Option 1: Ask Hermes Agent to install it

If Hermes has terminal and file tools available, just ask:

Install https://github.com/Q-Claw/gemini-cli-video-analysis and verify it works.

A sensible Hermes Agent should clone the repository, install it as a local skill, and verify that the helper script or skill is usable.

Option 2: Install as a Hermes Local Skill

If you want to install it manually inside your local Hermes setup:

git clone https://github.com/Q-Claw/gemini-cli-video-analysis.git
mkdir -p ~/.hermes/skills/media/gemini-cli-video-analysis
cp gemini-cli-video-analysis/SKILL.md ~/.hermes/skills/media/gemini-cli-video-analysis/
mkdir -p ~/.hermes/skills/media/gemini-cli-video-analysis/scripts
cp gemini-cli-video-analysis/scripts/gemini-video-analyze.sh ~/.hermes/skills/media/gemini-cli-video-analysis/scripts/
chmod +x ~/.hermes/skills/media/gemini-cli-video-analysis/scripts/gemini-video-analyze.sh

Then load it in Hermes with:

hermes -s gemini-cli-video-analysis
# or inside a session:
/skill gemini-cli-video-analysis

Option 3: Standalone Repository

Clone the repository to use the helper script directly:

git clone https://github.com/Q-Claw/gemini-cli-video-analysis.git
cd gemini-cli-video-analysis
chmod +x scripts/gemini-video-analyze.sh

License

MIT