helixlab

[!NOTE] All of the agents below use file-based configuration (AGENTS.md, GEMINI.md, .cursor/rules/). Placing these files in your project root makes them project-scoped automatically.

Cursor

HelixLab ships .cursor/rules/ for automatic context injection. Clone the repo and Cursor will detect the rules when video files are in context.

Alternatively, copy AGENTS.md to your project root — Cursor reads AGENTS.md natively.

OpenAI Codex

Codex reads AGENTS.md automatically. Clone or copy AGENTS.md to your project root.

Google Gemini (Code Assist / CLI / Jules)

Gemini reads GEMINI.md automatically. Clone or copy GEMINI.md to your project root.

[!TIP] Gemini supports hierarchical config — a global ~/.gemini/GEMINI.md plus a project-level GEMINI.md. You can also configure Gemini CLI to read AGENTS.md:

// ~/.gemini/settings.json
{ "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } }

Amazon Kiro

Kiro reads AGENTS.md from the project root. Clone or copy AGENTS.md to your project.

OpenCode / Amp / Goose / Devin / Warp / Zed / RooCode

All of these agents support the AGENTS.md standard. Clone or copy AGENTS.md to your project root.

All scripts work standalone — no plugin system required:

git clone https://github.com/mrrobertkent/helixlab-plugin.git
bash helixlab-plugin/skills/vision-replay/scripts/video-info.sh /path/to/video.mp4

# Get video info
bash skills/vision-replay/scripts/video-info.sh recording.webm

# Normalize (downscale + timestamp overlay)
bash skills/vision-replay/scripts/normalize-video.sh recording.webm /tmp/normalized.mp4

# Remove static/unchanged frames (threshold: 1=animation, 3=page-load, 15=workflow)
bash skills/vision-replay/scripts/dedupe-video.sh /tmp/normalized.mp4 /tmp/deduped.mp4 5

# Generate contact sheet overview
bash skills/vision-replay/scripts/contact-sheet.sh /tmp/deduped.mp4 /tmp/sheet.png