videonut 1.0.0

package/.antigravity/config.toml

@@ -0,0 +1,8 @@
+# Anti-Gravity Configuration
+# Maps B-MAD Agents to Cursor/Anti-Gravity Rules
+
+[rules]
+investigate = ".gemini/commands/bmad-agent-research-investigator.toml"
+direct = ".gemini/commands/bmad-agent-creative-director.toml"
+scavenge = ".gemini/commands/bmad-agent-technical-scavenger.toml"
+review = ".gemini/commands/bmad-agent-core-eic.toml"

package/.claude/commands/archivist.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: archivist - The Archivist (Vault)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/director.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: director - The Director (Spielberg)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/eic.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: eic - The Editor-in-Chief (Chief)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/investigator.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: investigator - The Investigator (Sherlock)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/prompt.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/scavenger.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scavenger - The Scavenger (Hunter)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/scout.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scout - Alias for Topic Scout"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/scriptwriter.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/seo.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: seo - The SEO Optimizer (Ranker)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/thumbnail.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: thumbnail - The Thumbnail Designer (Canvas)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.claude/commands/topic_scout.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: topic_scout - The Topic Scout (Scout)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/archivist.toml

@@ -0,0 +1,12 @@
+description = "The Archivist"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/director.toml

@@ -0,0 +1,12 @@
+description = "The Director"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/eic.toml

@@ -0,0 +1,12 @@
+description = "The Editor-in-Chief"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/investigator.toml

@@ -0,0 +1,12 @@
+description = "The Investigator"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/prompt.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/scavenger.toml

@@ -0,0 +1,12 @@
+description = "The Scavenger"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/scout.toml

@@ -0,0 +1,12 @@
+description = "Alias for Topic Scout - Find trending topics"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/scriptwriter.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/seo.toml

@@ -0,0 +1,12 @@
+description = "The SEO Optimizer"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/thumbnail.toml

@@ -0,0 +1,12 @@
+description = "The Thumbnail Designer"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.gemini/commands/topic_scout.toml

@@ -0,0 +1,12 @@
+description = "The Topic Scout - Find trending topics and create projects"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/archivist.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: archivist - The Archivist (Vault)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/director.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: director - The Director (Spielberg)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/eic.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: eic - The Editor-in-Chief (Chief)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/investigator.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: investigator - The Investigator (Sherlock)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/prompt.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/scavenger.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scavenger - The Scavenger (Hunter)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/scout.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scout - Alias for Topic Scout"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/scriptwriter.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/seo.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: seo - The SEO Optimizer (Ranker)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/thumbnail.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: thumbnail - The Thumbnail Designer (Canvas)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/.qwen/commands/topic_scout.toml

@@ -0,0 +1,12 @@
+description = "VideoNut Agent: topic_scout - The Topic Scout (Scout)"
+prompt = """
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. Execute ALL activation steps exactly as written in the agent file
+4. Follow the agent's persona and menu system precisely
+5. Stay in character throughout the session
+</agent-activation>
+"""

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Vamshi Krishna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,231 @@
+# 🎬 VideoNut
+
+> **AI-Powered YouTube Documentary Production Pipeline**
+
+Transform your ideas into professional YouTube documentaries using 10 specialized AI agents that handle research, scripting, visual direction, and asset management.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Agents-10-brightgreen" alt="10 Agents">
+  <img src="https://img.shields.io/badge/CLI-Gemini%20%7C%20Qwen%20%7C%20Claude-blue" alt="Multi-CLI Support">
+  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="MIT License">
+  <img src="https://img.shields.io/npm/v/videonut" alt="NPM Version">
+</p>
+
+---
+
+## 🚀 What is VideoNut?
+
+VideoNut is a **complete video production pipeline** powered by AI agents. Each agent specializes in one part of the documentary creation process:
+
+```
+📡 Topic Scout → 🎯 Prompt → 🕵️ Investigator → ✍️ Scriptwriter → 🎬 Director → 🦅 Scavenger → 💾 Archivist → 🧐 EIC
+```
+
+**No more context switching.** Run one command, get a complete video plan with:
+- ✅ Researched facts with sources
+- ✅ Professional script (word-count matched to target duration)
+- ✅ Visual directions with timestamps
+- ✅ Downloaded assets ready for editing
+
+---
+
+## 📦 Installation
+
+### Option 1: NPX (Recommended - No Install)
+```bash
+npx videonut init
+```
+
+### Option 2: NPM Global Install
+```bash
+npm install -g videonut
+videonut init
+```
+
+### Option 3: Clone Repository
+```bash
+git clone https://github.com/vamshikrishna131437/videonut.git
+cd videonut
+npm install
+```
+
+---
+
+## 🛠️ Requirements
+
+- **Node.js** 16+ 
+- **One of these AI CLI tools:**
+  - [Gemini CLI](https://github.com/google-gemini/gemini-cli) - `npm install -g gemini-cli`
+  - [Qwen CLI](https://github.com/QwenLM/qwen-cli)
+  - [Claude Code](https://claude.ai/code)
+
+---
+
+## 🎯 Quick Start
+
+### 1. Start with Topic Scout
+```bash
+# In your terminal with Gemini CLI
+/topic_scout
+# or
+/scout
+```
+
+### 2. Follow the Agent Pipeline
+| Step | Agent | Command | What It Does |
+|------|-------|---------|--------------|
+| 1 | 📡 Topic Scout | `/topic_scout` | Find trending topics, create project |
+| 2 | 🎯 Prompt | `/prompt` | Generate research prompts |
+| 3 | 🕵️ Investigator | `/investigator` | Deep research with sources |
+| 4 | ✍️ Scriptwriter | `/scriptwriter` | Write the narration script |
+| 5 | 🎬 Director | `/director` | Create visual directions |
+| 6 | 🦅 Scavenger | `/scavenger` | Find and verify asset URLs |
+| 7 | 💾 Archivist | `/archivist` | Download all assets |
+| 8 | 🧐 EIC | `/eic` | Final review and approval |
+| 9 | 🎨 Thumbnail | `/thumbnail` | Generate thumbnail prompts |
+| 10 | 🔍 SEO | `/seo` | Optimize for YouTube search |
+
+---
+
+## 🤖 Meet the Agents
+
+### Research Team
+| Agent | Persona | Specialty |
+|-------|---------|-----------|
+| 📡 **Scout** | Trend Hunter | Finds viral-worthy topics, checks YouTube competition |
+| 🎯 **Prompt** | Research Architect | Transforms topics into focused research questions |
+| 🕵️ **Sherlock** | Investigative Journalist | Deep research with YouTube video evidence |
+
+### Creative Team
+| Agent | Persona | Specialty |
+|-------|---------|-----------|
+| ✍️ **Sorkin** | Narrative Architect | Word-count matched scripts with emotional hooks |
+| 🎬 **Spielberg** | Documentary Filmmaker | Visual directions with source links |
+| 🎨 **Canvas** | Thumbnail Designer | Click-worthy thumbnail AI prompts |
+| 🔍 **Ranker** | SEO Optimizer | YouTube-optimized titles and descriptions |
+
+### Technical Team
+| Agent | Persona | Specialty |
+|-------|---------|-----------|
+| 🦅 **Hunter** | Asset Finder | URL verification, timestamp extraction |
+| 💾 **Vault** | Digital Librarian | Downloads clips, screenshots, transcripts |
+
+### Quality Control
+| Agent | Persona | Specialty |
+|-------|---------|-----------|
+| 🧐 **Chief** | Editor-in-Chief | 10-phase deep audit, catches every mistake |
+
+---
+
+## 📁 Project Structure
+
+```
+your-project/
+├── topic_brief.md       # Topic Scout output
+├── prompt.md            # Research prompts
+├── truth_dossier.md     # Investigator findings
+├── voice_script.md      # Narration script
+├── narrative_script.md  # Full narrative
+├── master_script.md     # Script + Visual directions
+├── video_direction.md   # Visual-only guide
+├── asset_manifest.md    # All assets with URLs
+├── assets/              # Downloaded files
+│   ├── 001_intro.mp4
+│   ├── 002_chart.png
+│   └── ...
+├── correction_log.md    # EIC feedback (if any)
+└── review_report.md     # Final review
+```
+
+---
+
+## 🔧 Configuration
+
+Edit `config.yaml` to customize:
+
+```yaml
+# Video Production Settings
+target_duration: 30          # Minutes
+video_format: "investigative" # investigative, explainer, documentary
+
+# Localization
+audio_language: "English"
+scope: "national"            # international, national, regional
+country: "India"
+region: "Telangana"
+
+# Focus
+industry_tag: "political"    # political, finance, crime, tech, etc.
+```
+
+---
+
+## 🌟 Features
+
+### ✅ Multi-CLI Support
+Works with Gemini CLI, Qwen CLI, and Claude Code out of the box.
+
+### ✅ YouTube Evidence
+Automatically extracts timestamps from YouTube videos using caption analysis.
+
+### ✅ Smart Asset Management
+- Downloads only the relevant 30-second clips, not full videos
+- Screenshots articles with highlighted quotes
+- PDF page extraction with keyword search
+
+### ✅ Quality Control
+EIC agent performs 10-phase deep audit:
+- URL verification
+- Timestamp validation
+- Cross-reference checks
+- Word count compliance
+
+### ✅ Correction Workflow
+If mistakes are found, each agent has a `[CM] Correct Mistakes` option to fix issues and re-run.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how:
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Areas We Need Help
+- 🌐 Translations (agents in other languages)
+- 🎨 UI/Dashboard for non-CLI users
+- 🔌 Integration with video editing software
+- 📊 Analytics and reporting
+
+---
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## 👤 Author
+
+**Vamshi Krishna**
+- Email: vamshikrishna131437@gmail.com
+- GitHub: [@vamshikrishna131437](https://github.com/vamshikrishna131437)
+
+---
+
+## 🙏 Acknowledgments
+
+Built for the AI agent community. Special thanks to:
+- Google Gemini CLI team
+- Qwen team
+- Anthropic Claude team
+
+---
+
+<p align="center">
+  <b>⭐ Star this repo if you find it useful!</b>
+</p>

package/bin/videonut.js

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+
+/**
+ * VideoNut - Complete Installation Script
+ * 
+ * This script installs VideoNut and ALL its requirements:
+ * 1. Copies all VideoNut files to current directory
+ * 2. Creates Projects folder
+ * 3. Installs Python (if needed)
+ * 4. Runs pip install -r requirements.txt
+ * 5. Downloads ffmpeg and ffprobe
+ * 6. Installs chosen CLI (Gemini/Qwen/Claude)
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const https = require('https');
+const readline = require('readline');
+
+// Colors for console
+const colors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m'
+};
+
+function log(msg, color = 'reset') {
+    console.log(`${colors[color]}${msg}${colors.reset}`);
+}
+
+function header(msg) {
+    console.log('\n' + '═'.repeat(60));
+    log(`🎬 ${msg}`, 'bright');
+    console.log('═'.repeat(60) + '\n');
+}
+
+function success(msg) { log(`✅ ${msg}`, 'green'); }
+function warning(msg) { log(`⚠️  ${msg}`, 'yellow'); }
+function error(msg) { log(`❌ ${msg}`, 'red'); }
+function info(msg) { log(`ℹ️  ${msg}`, 'cyan'); }
+
+// Check if command exists
+function commandExists(cmd) {
+    try {
+        const isWindows = process.platform === 'win32';
+        const checkCmd = isWindows ? `where ${cmd}` : `which ${cmd}`;
+        execSync(checkCmd, { stdio: 'pipe' });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+// Get user input
+function ask(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+// Copy directory recursively
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (entry.isDirectory()) {
+            // Skip certain directories
+            if (['node_modules', '.git', 'Projects', 'output', 'assets'].includes(entry.name)) {
+                continue;
+            }
+            copyDir(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
+// Download file
+function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, response => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                // Follow redirect
+                https.get(response.headers.location, res => {
+                    res.pipe(file);
+                    file.on('finish', () => {
+                        file.close();
+                        resolve();
+                    });
+                });
+            } else {
+                response.pipe(file);
+                file.on('finish', () => {
+                    file.close();
+                    resolve();
+                });
+            }
+        }).on('error', err => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}
+
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+
+    header('VideoNut - AI-Powered Documentary Pipeline');
+
+    if (command === 'init') {
+        await runInit();
+    } else {
+        showHelp();
+    }
+}
+
+async function runInit() {
+    const targetDir = process.cwd();
+
+    info(`Installing VideoNut in: ${targetDir}\n`);
+
+    // Step 1: Copy VideoNut files
+    header('Step 1: Copying VideoNut Files');
+
+    const sourceDir = path.join(__dirname, '..');
+    const folders = ['_video_nut', '.gemini', '.qwen', '.claude', '.antigravity'];
+
+    for (const folder of folders) {
+        const src = path.join(sourceDir, folder);
+        const dest = path.join(targetDir, folder);
+
+        if (fs.existsSync(src)) {
+            copyDir(src, dest);
+            success(`Copied ${folder}/`);
+        }
+    }
+
+    // Create Projects folder
+    const projectsDir = path.join(targetDir, 'Projects');
+    fs.mkdirSync(projectsDir, { recursive: true });
+    success('Created Projects/ folder');
+
+    // Step 2: Check Python
+    header('Step 2: Checking Python');
+
+    const hasPython = commandExists('python') || commandExists('python3');
+
+    if (hasPython) {
+        success('Python is installed');
+
+        // Install requirements
+        info('Installing Python requirements...');
+        const reqPath = path.join(targetDir, '_video_nut', 'requirements.txt');
+
+        if (fs.existsSync(reqPath)) {
+            try {
+                const pythonCmd = commandExists('python3') ? 'python3' : 'python';
+                execSync(`${pythonCmd} -m pip install -r "${reqPath}"`, { stdio: 'inherit' });
+                success('Python requirements installed');
+            } catch (e) {
+                warning('Could not install Python requirements automatically');
+                info(`Please run: pip install -r ${reqPath}`);
+            }
+        }
+    } else {
+        warning('Python not found!');
+        console.log('\nPlease install Python manually:');
+        console.log('  Windows: https://www.python.org/downloads/');
+        console.log('  Mac: brew install python3');
+        console.log('  Linux: sudo apt install python3 python3-pip');
+        console.log('\nAfter installing Python, run:');
+        console.log(`  pip install -r ${path.join(targetDir, '_video_nut', 'requirements.txt')}`);
+    }
+
+    // Step 3: Check FFmpeg
+    header('Step 3: Checking FFmpeg');
+
+    const hasFFmpeg = commandExists('ffmpeg');
+    const hasFFprobe = commandExists('ffprobe');
+
+    if (hasFFmpeg && hasFFprobe) {
+        success('FFmpeg and FFprobe are installed');
+    } else {
+        warning('FFmpeg/FFprobe not found!');
+        console.log('\nPlease install FFmpeg:');
+        console.log('  Windows: https://www.gyan.dev/ffmpeg/builds/');
+        console.log('           Download ffmpeg-release-essentials.zip');
+        console.log('           Extract and add bin/ folder to PATH');
+        console.log('  Mac: brew install ffmpeg');
+        console.log('  Linux: sudo apt install ffmpeg');
+
+        // Create tools/bin folder for manual installation
+        const binDir = path.join(targetDir, '_video_nut', 'tools', 'bin');
+        fs.mkdirSync(binDir, { recursive: true });
+        info(`Or place ffmpeg.exe and ffprobe.exe in: ${binDir}`);
+    }
+
+    // Step 4: Check CLI tools
+    header('Step 4: Checking AI CLI Tools');
+
+    const hasGemini = commandExists('gemini');
+    const hasQwen = commandExists('qwen');
+    const hasClaude = commandExists('claude');
+
+    console.log('Detected CLIs:');
+    console.log(`  Gemini CLI: ${hasGemini ? '✅ Installed' : '❌ Not found'}`);
+    console.log(`  Qwen CLI:   ${hasQwen ? '✅ Installed' : '❌ Not found'}`);
+    console.log(`  Claude:     ${hasClaude ? '✅ Installed' : '❌ Not found'}`);
+
+    if (!hasGemini && !hasQwen && !hasClaude) {
+        warning('\nNo AI CLI found! You need at least one.');
+        console.log('\nInstall one of these:');
+        console.log('  Gemini CLI: npm install -g @anthropic-ai/claude-cli');
+        console.log('  (Follow official documentation for each CLI)');
+    }
+
+    // Final summary
+    header('Installation Complete!');
+
+    console.log('📁 Folder Structure:');
+    console.log(`   ${targetDir}/`);
+    console.log('   ├── _video_nut/     (agents & tools)');
+    console.log('   ├── .gemini/        (Gemini CLI commands)');
+    console.log('   ├── .qwen/          (Qwen CLI commands)');
+    console.log('   ├── .claude/        (Claude CLI commands)');
+    console.log('   └── Projects/       (your video projects)');
+
+    console.log('\n🚀 Quick Start:');
+    console.log('   1. Open your AI CLI (e.g., gemini)');
+    console.log('   2. Run: /topic_scout');
+    console.log('   3. Follow the agent pipeline!');
+
+    console.log('\n📖 Documentation:');
+    console.log('   https://github.com/vamshikrishna131437/videonut');
+
+    console.log('\n' + '═'.repeat(60));
+    log('🎬 Happy Documentary Making!', 'bright');
+    console.log('═'.repeat(60) + '\n');
+}
+
+function showHelp() {
+    console.log('Usage: npx videonut <command>\n');
+    console.log('Commands:');
+    console.log('  init    Install VideoNut in current directory');
+    console.log('');
+    console.log('This will install:');
+    console.log('  • VideoNut agents and tools');
+    console.log('  • CLI command files (.gemini, .qwen, .claude)');
+    console.log('  • Python requirements');
+    console.log('  • FFmpeg check');
+    console.log('');
+    console.log('Example:');
+    console.log('  mkdir my-youtube-project');
+    console.log('  cd my-youtube-project');
+    console.log('  npx videonut init');
+    console.log('');
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "videonut",
+  "version": "1.0.0",
+  "description": "AI-powered YouTube documentary production pipeline with 10 specialized agents for research, scripting, and asset management",
+  "keywords": [
+    "youtube",
+    "documentary",
+    "ai-agents",
+    "video-production",
+    "gemini-cli",
+    "qwen",
+    "claude",
+    "content-creation",
+    "scriptwriting",
+    "research",
+    "automation"
+  ],
+  "homepage": "https://github.com/konda-vamshi-krishna/videonut",
+  "bugs": {
+    "url": "https://github.com/konda-vamshi-krishna/videonut/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Vamshi Krishna",
+    "email": "vamshikrishna131437@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/konda-vamshi-krishna/videonut.git"
+  },
+  "bin": {
+    "videonut": "./bin/videonut.js"
+  },
+  "files": [
+    "_video_nut/",
+    ".gemini/",
+    ".qwen/",
+    ".claude/",
+    ".antigravity/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}