npm - @leejungkiin/awkit - Versions diffs - 1.3.8 → 1.4.2 - Mend

@leejungkiin/awkit 1.3.8 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (135) hide show

package/skills/short-maker/outputs/fitbite-promo/script.md ADDED Viewed

@@ -0,0 +1,19 @@
+# FitBite Pro - Promo Script (Green Screen)
+**Concept:** A modern fitness coach avatar on a green screen, explaining the core value of FitBite Pro. The background will be replaced later in video_mixer.
+## Scene 1: Hook (Attention)
+- **Visual:** A young enthusiastic female fitness coach wearing sports attire, pointing directly at the camera with an excited but empathetic expression. She is standing on a solid chroma green screen background.
+- **Audio (Vietnamese):** Gặp khó khăn khi theo dõi dinh dưỡng hàng ngày?
+## Scene 2: Interest
+- **Visual:** The same fitness coach looking at a modern smartphone in her hand, smiling broadly. Solid chroma green screen background.
+- **Audio (Vietnamese):** FitBite Pro với AI thông minh sẽ tự động lên thực đơn chuẩn y khoa cho bạn.
+## Scene 3: Desire
+- **Visual:** The fitness coach standing in a strong, confident pose with arms crossed, nodding approvingly. Solid chroma green screen background.
+- **Audio (Vietnamese):** Báo cáo chi tiết, giao diện tối ưu hoàn hảo cho cả iPad.
+## Scene 4: Action (CTA)
+- **Visual:** The fitness coach showing a "Download now" gesture with both hands pointing down. Solid chroma green screen background.
+- **Audio (Vietnamese):** Tải ngay FitBite Pro trên App Store để thay đổi vóc dáng!

package/skills/short-maker/outputs/fitbite-promo/segments/scene-01.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/segments/scene-02.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/segments/scene-03.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/segments/scene-04.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/storyboard/scene-01.png ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/storyboard/scene-02.png ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/storyboard/scene-03.png ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/storyboard/scene-04.png ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/storyboard.html ADDED Viewed

@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Storyboard Preview</title>
+  <style>
+    :root {
+      --bg: #121212; --card-bg: #1E1E1E; --text: #E0E0E0; --accent: #BB86FC; --accent-hover: #9965f4;
+    }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      background-color: var(--bg); color: var(--text); padding: 20px;
+    }
+    header { text-align: center; margin-bottom: 30px; }
+    h1 { margin: 0; color: var(--accent); }
+    .meta { color: #888; font-size: 0.9em; margin-top: 5px; }
+    .grid {
+      display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 20px;
+    }
+    .card {
+      background: var(--card-bg); border-radius: 12px; overflow: hidden;
+      box-shadow: 0 4px 6px rgba(0,0,0,0.3); border: 1px solid #333;
+    }
+    .card-img-wrapper { position: relative; padding-top: 56.25%; /* 16:9 Aspect Ratio */ background: #000; }
+    .card img {
+      position: absolute; top: 0; left: 0; width: 100%; height: 100%; object-fit: cover;
+    }
+    .scene-number {
+      position: absolute; top: 10px; left: 10px; background: rgba(0,0,0,0.7);
+      color: #fff; padding: 4px 8px; border-radius: 6px; font-weight: bold; font-size: 0.8em;
+    }
+    .card-content { padding: 15px; }
+    .duration { color: var(--accent); font-weight: bold; font-size: 0.9em; margin-bottom: 8px; }
+    .script { font-size: 1em; line-height: 1.4; margin-bottom: 12px; }
+    .prompt { font-size: 0.8em; color: #888; font-style: italic; background: #2a2a2a; padding: 8px; border-radius: 6px; }
+    .timeline-bar {
+      height: 6px; background: #333; margin-top: 30px; border-radius: 3px; position: relative; overflow: hidden;
+    }
+    .timeline-progress { height: 100%; background: var(--accent); width: 0%; }
+  </style>
+</head>
+<body>
+  <header>
+    <h1 id="title">Loading Storyboard...</h1>
+    <div class="meta" id="meta">Duration: 0s</div>
+  </header>
+  <div class="timeline-bar">
+    <div class="timeline-progress" id="timeline"></div>
+  </div>
+  <div class="grid" id="grid">
+    <!-- Cards will be injected here -->
+  </div>
+  <script>
+    async function loadStoryboard() {
+        const data = {
+          "title": "FitBite Pro - Promo Storyboard",
+          "duration": 12,
+          "target_format": "16:9",
+          "scenes": [
+              {
+                  "id": "1",
+                  "duration": 3,
+                  "image": "storyboard/scene-01.png",
+                  "script": "Gặp khó khăn khi theo dõi dinh dưỡng hàng ngày?",
+                  "prompt": "A young enthusiastic female fitness coach wearing modern sports attire..."
+              },
+              {
+                  "id": "2",
+                  "duration": 3,
+                  "image": "storyboard/scene-02.png",
+                  "script": "FitBite Pro với AI thông minh sẽ tự động lên thực đơn chuẩn y khoa cho bạn.",
+                  "prompt": "A young enthusiastic female fitness coach looking at a smartphone..."
+              },
+              {
+                  "id": "3",
+                  "duration": 3,
+                  "image": "storyboard/scene-03.png",
+                  "script": "Báo cáo chi tiết, giao diện tối ưu hoàn hảo cho cả iPad.",
+                  "prompt": "A young enthusiastic female fitness coach standing in a strong confident pose..."
+              },
+              {
+                  "id": "4",
+                  "duration": 3,
+                  "image": "storyboard/scene-04.png",
+                  "script": "Tải ngay FitBite Pro trên App Store để thay đổi vóc dáng!",
+                  "prompt": "A young enthusiastic female fitness coach showing a download now gesture..."
+              }
+          ]
+        };
+        document.getElementById('title').textContent = data.title || 'App Promo Storyboard';
+        document.getElementById('meta').textContent = `Total Duration: ${data.duration || 0}s | Video Target: ${data.target_format || '16:9'}`;
+        const grid = document.getElementById('grid');
+        grid.innerHTML = '';
+        let totalTime = data.duration || 1; // avoid /0
+        let cumulative = 0;
+        data.scenes.forEach((scene, index) => {
+          cumulative += scene.duration;
+          const card = document.createElement('div');
+          card.className = 'card';
+          card.innerHTML = `
+            <div class="card-img-wrapper">
+              <img src="${scene.image || 'https://via.placeholder.com/640x360?text=Generating+Image...'}" alt="Scene ${scene.id}">
+              <div class="scene-number">Scene ${scene.id}</div>
+            </div>
+            <div class="card-content">
+              <div class="duration">⏱️ ${scene.duration}s</div>
+              <div class="script">🎙️ "${scene.script}"</div>
+              <div class="prompt">🎨 Prompt: ${scene.prompt}</div>
+            </div>
+          `;
+          grid.appendChild(card);
+        });
+        // Setup dumb timeline animation for fun
+        const timeline = document.getElementById('timeline');
+        timeline.style.width = '100%';
+        timeline.style.transition = `width ${data.duration}s linear`;
+    }
+    loadStoryboard();
+  </script>
+</body>
+</html>

package/skills/short-maker/outputs/fitbite-promo/storyboard.json ADDED Viewed

@@ -0,0 +1,38 @@
+{
+    "project": "fitbite-promo",
+    "background_music": "energetic_corporate_pop",
+    "scenes": [
+        {
+            "id": "scene-01",
+            "type": "hook",
+            "image_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, pointing directly at the camera with an excited but empathetic expression, standing on a solid chroma green screen background, highly detailed, cinematic lighting, 8k resolution.",
+            "video_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, pointing directly at the camera with an excited but empathetic expression, standing on a solid chroma green screen background. She speaks with a British accent: \"Struggling to keep track of your daily nutrition?\". High quality, smooth motion, 4k.",
+            "tts_text": "Struggling to keep track of your daily nutrition?",
+            "status": "pending_image"
+        },
+        {
+            "id": "scene-02",
+            "type": "interest",
+            "image_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, looking at a modern smartphone in her hand and smiling broadly, standing on a solid chroma green screen background, highly detailed, cinematic lighting, 8k resolution.",
+            "video_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, looking at a modern smartphone in her hand and smiling broadly, standing on a solid chroma green screen background. She speaks with a British accent: \"FitWitness, with its smart AI, will automatically create medically approved meal plans for you.\". High quality, smooth motion, 4k.",
+            "tts_text": "FitWitness, with its smart AI, will automatically create medically approved meal plans for you.",
+            "status": "pending_image"
+        },
+        {
+            "id": "scene-03",
+            "type": "desire",
+            "image_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, standing in a strong confident pose with arms crossed, nodding approvingly, standing on a solid chroma green screen background, highly detailed, cinematic lighting, 8k resolution.",
+            "video_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, standing in a strong confident pose with arms crossed, nodding approvingly, standing on a solid chroma green screen background. She speaks with a British accent: \"Detailed reports, and an interface perfectly optimised for iPad.\". High quality, smooth motion, 4k.",
+            "tts_text": "Detailed reports, and an interface perfectly optimised for iPad.",
+            "status": "pending_image"
+        },
+        {
+            "id": "scene-04",
+            "type": "action",
+            "image_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, showing a download now gesture by pointing down with both index fingers, standing on a solid chroma green screen background, highly detailed, cinematic lighting, 8k resolution.",
+            "video_prompt": "A young enthusiastic female fitness coach wearing modern sports attire, showing a download now gesture by pointing down with both index fingers, standing on a solid chroma green screen background. She speaks with a British accent: \"Download FitWitness on the App Store today to transform your body!\". High quality, smooth motion, 4k.",
+            "tts_text": "Download FitWitness on the App Store today to transform your body!",
+            "status": "pending_image"
+        }
+    ]
+}

package/skills/short-maker/outputs/fitbite-promo/temp/merged_chroma.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/temp/merged_crossfaded.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/temp/ready_00.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/temp/ready_01.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/temp/ready_02.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/temp/ready_03.mp4 ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/tts/manifest.json ADDED Viewed

@@ -0,0 +1,31 @@
+{
+  "endpoint": "https://api.lucylab.io/json-rpc",
+  "speed": 1.0,
+  "blockVersion": 0,
+  "mode": "script-scenes",
+  "voices": [
+    {
+      "id": "nqak8C85bsAG5mihyunRkj",
+      "name": "Chi Chi",
+      "slug": "chi-chi"
+    }
+  ],
+  "items": [
+    {
+      "label": "scene-01",
+      "text": "Gặp khó khăn khi theo dõi dinh dưỡng hàng ngày?"
+    },
+    {
+      "label": "scene-02",
+      "text": "FitBite Pro với AI thông minh sẽ tự động lên thực đơn chuẩn y khoa cho bạn."
+    },
+    {
+      "label": "scene-03",
+      "text": "Báo cáo chi tiết, giao diện tối ưu hoàn hảo cho cả iPad."
+    },
+    {
+      "label": "scene-04",
+      "text": "Tải ngay FitBite Pro trên App Store để thay đổi vóc dáng!"
+    }
+  ]
+}

package/skills/short-maker/outputs/fitbite-promo/tts/scene-01.wav ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/tts/scene-02.wav ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/tts/scene-03.wav ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/tts/scene-04.wav ADDED Viewed

Binary file

package/skills/short-maker/outputs/fitbite-promo/tts_script.txt ADDED Viewed

@@ -0,0 +1,11 @@
+SCENE 1:
+Tông giọng: 'Gặp khó khăn khi theo dõi dinh dưỡng hàng ngày?'
+SCENE 2:
+Tông giọng: 'FitBite Pro với AI thông minh sẽ tự động lên thực đơn chuẩn y khoa cho bạn.'
+SCENE 3:
+Tông giọng: 'Báo cáo chi tiết, giao diện tối ưu hoàn hảo cho cả iPad.'
+SCENE 4:
+Tông giọng: 'Tải ngay FitBite Pro trên App Store để thay đổi vóc dáng!'

package/skills/short-maker/scripts/google-flow-cli/.project-identity ADDED Viewed

@@ -0,0 +1,41 @@
+{
+  "_comments": {
+    "projectId": "Auto-generated. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run \"awkit trello info\" to verify."
+  },
+  "projectName": "GoogleFlowCli",
+  "projectId": "googleflowcli",
+  "projectType": "mobile-firebase",
+  "bundleIdentifier": "com.company.googleflowcli",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "Mobile",
+    "backend": "Firebase"
+  },
+  "services": {
+    "firebase": {
+      "enabled": true,
+      "features": [
+        "analytics",
+        "crashlytics",
+        "remote-config",
+        "auth"
+      ]
+    }
+  },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
+  "projectStage": "development",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-4",
+    "lineLength": 120
+  },
+  "projectGoals": [],
+  "createdDate": "2026-03-29",
+  "lastUpdated": "2026-03-29"
+}

package/skills/short-maker/scripts/google-flow-cli/.trae/rules/project_rules.md ADDED Viewed

@@ -0,0 +1,52 @@
+# Project Rules (gflow)
+## Cost Model
+- Image generation is free (0 credits).
+- Video generation costs 20 credits per video.
+## Workflow Optimization (Credits)
+- Default to images first: use image generation to validate prompts, style, character consistency, and scene composition.
+- Only generate videos after explicit approval that the image storyboard is acceptable.
+- When videos are required, minimize iterations:
+  - Keep prompts stable and only adjust one variable at a time.
+  - Prefer shorter runs (e.g., single segment) before multi-segment/extended workflows.
+  - Avoid unnecessary retries or batch runs unless requested.
+## Output Planning
+- For scripts/storyboards: generate one image per scene first, then move to video generation.
+- Always save outputs under `outputs/` with a predictable naming scheme (scene/seg numbering).
+## Voiceover (TTS)
+- Videos generated by Flow may come without voice. Treat voice as a separate pipeline step.
+- TTS is mandatory via LucyLab JSON-RPC only (use runtime config, avoid keeping local capture/log files in repo).
+- Do not use local TTS (e.g., macOS `say`) in this project.
+## TTS Tooling
+- **LucyLab batch TTS script**: `python lucylab_tts.py`
+  - Token handling:
+    - Use environment variable `LUCYLAB_BEARER` (do not store bearer tokens in repo files).
+  - Voice selection:
+    - Prefer explicit `--voice <id>[:name]` to avoid storing voice catalogs in repo.
+    - If a voice catalog is needed for AI selection, keep a compact library file with only `items[].{id,name,description,tag}`.
+  - Common usage:
+    - Plain text:
+      - `LUCYLAB_BEARER=... python lucylab_tts.py --out-dir outputs/tts-lucylab --voice <id>:<name> --text "..." `
+    - Script mode (extracts thoại from `SCENE ... '...')`:
+      - `LUCYLAB_BEARER=... python lucylab_tts.py --out-dir outputs/tts-lucylab --voice <id>:<name> --text-file script.txt`
+    - Build compact voice library from a captured log file:
+      - `python lucylab_tts.py --voice-json voice.json --export-voice-library voices_library.json`
+    - Build split voice library folder (load only one chunk/category into AI context):
+      - `python lucylab_tts.py --voice-json voice.json --export-voice-library outputs/voice_library`
+- **Audio to video merge** (ffmpeg): add the generated voiceover track to the final merged video after transitions.
+  - Output naming convention:
+    - Video without VO: `outputs/.../script-full.mp4`
+    - Video with VO: `outputs/.../script-full-vo.mp4`
+## Safety
+- Never commit or share bearer tokens (e.g., from `tts_curl.txt`). Use `LUCYLAB_BEARER` and keep local-only artifacts under `outputs/`.

package/skills/short-maker/scripts/google-flow-cli/CODEBASE.md ADDED Viewed

@@ -0,0 +1,67 @@
+# GoogleFlowCli — Codebase Map
+> **Project Type:** mobile-firebase | **Tech Stack:** Mobile + Firebase
+> **Last Synced:** 2026-03-29
+> [!NOTE]
+> AI PHẢI đọc file này TRƯỚC KHI dùng `grep_search` / `codebase_search` / `list_dir`.
+> Đọc → xác định target → search cụ thể. KHÔNG search "mù".
+---
+## 🗺️ Directory Structure
+```
+src/
+├── features/
+├── services/
+└── models/
+```
+---
+## 📁 File Index
+> Compact format: `path` → purpose (1 line mỗi file)
+### Core / Infrastructure
+| Path | Purpose |
+|------|---------|
+| `{{CORE_FILE_1}}` | {{PURPOSE_1}} |
+| `{{CORE_FILE_2}}` | {{PURPOSE_2}} |
+### Features
+| Path | Purpose |
+|------|---------|
+| `{{FEATURE_FILE_1}}` | {{PURPOSE_1}} |
+| `{{FEATURE_FILE_2}}` | {{PURPOSE_2}} |
+### UI / Views
+| Path | Purpose |
+|------|---------|
+| `{{VIEW_FILE_1}}` | {{PURPOSE_1}} |
+| `{{VIEW_FILE_2}}` | {{PURPOSE_2}} |
+> ⚠️ Thêm file mới vào section phù hợp. Dùng `/codebase-sync` để auto-update.
+---
+## 🔑 Key Files
+| File | Purpose |
+|------|---------|
+| `.project-identity` | AI project context |
+| `CODEBASE.md` | This file — codebase map for AI |
+---
+## 📝 Notes
+_Architecture decisions, gotchas, và context quan trọng._
+---
+*Auto-generated by `awkit init` — keep updated with `/codebase-sync`*

package/skills/short-maker/scripts/google-flow-cli/GoogleFlowCli.code-workspace ADDED Viewed

@@ -0,0 +1,29 @@
+{
+  "folders": [
+    {
+      "path": "."
+    }
+  ],
+  "settings": {
+    "editor.formatOnSave": true,
+    "editor.tabSize": 4,
+    "files.exclude": {
+      "**/.DS_Store": true,
+      "**/node_modules": true,
+      "**/.git": true,
+      "**/build": false,
+      "**/.gradle": false,
+      "**/DerivedData": false
+    },
+    "files.watcherExclude": {
+      "**/node_modules/**": true,
+      "**/build/**": true,
+      "**/DerivedData/**": true
+    }
+  },
+  "extensions": {
+    "recommendations": [
+      "github.copilot"
+    ]
+  }
+}

package/skills/short-maker/scripts/google-flow-cli/README.md ADDED Viewed

@@ -0,0 +1,168 @@
+# gflow — CLI for Google Flow
+A command-line interface to [Google Flow](https://flow.google) (AI image & video generation), built using the same reverse-engineering approach as [tmc/nlm](https://github.com/tmc/nlm) for NotebookLM.
+Lets AI agents and scripts generate images/videos via Google Flow without the GUI.
+## Architecture
+```
+┌────────────────────────────────────┐
+│  CLI Layer (click)                 │  gflow/cli/main.py
+│  generate-image, generate-video,   │
+│  list, download, collections, raw  │
+├────────────────────────────────────┤
+│  API Client (FlowClient)          │  gflow/api/client.py
+│  High-level ops, polling, parsing  │
+├────────────────────────────────────┤
+│  BatchExecute Protocol            │  gflow/batchexecute/client.py
+│  RPC encoding, SAPISIDHASH,       │
+│  chunked response decoding         │
+├────────────────────────────────────┤
+│  Browser Auth                     │  gflow/auth/browser_auth.py
+│  Cookie extraction from Chrome,    │
+│  Selenium interactive login        │
+└────────────────────────────────────┘
+```
+This is the same layered architecture as `tmc/nlm`:
+- **Auth** extracts Google cookies from your browser (browser_cookie3 or Selenium)
+- **BatchExecute** encodes RPCs into Google's wire format and decodes responses
+- **API Client** wraps BatchExecute with typed methods for each Flow feature
+- **CLI** exposes everything as clean subcommands
+## Install
+```bash
+pip install -e .
+```
+Or with optional Selenium support for interactive login:
+```bash
+pip install -e ".[dev]"
+pip install selenium
+```
+## Quick Start
+```bash
+# 1. Authenticate (extracts cookies from your Chrome browser)
+gflow auth
+# 2. Generate an image
+gflow generate-image "a cat astronaut floating in space"
+# 3. Generate a video
+gflow generate-video "a timelapse of a flower blooming"
+# 4. List your assets
+gflow list
+# 5. Download an asset
+gflow download <asset-id> -o output.png
+```
+## Setup: Discovering RPC IDs
+Google Flow uses the same BatchExecute protocol as NotebookLM, but with different RPC endpoint IDs. You need to discover these by inspecting network traffic:
+1. Open [flow.google](https://flow.google) in Chrome
+2. Open DevTools → Network tab
+3. Filter requests by `batchexecute`
+4. Perform an action (e.g., generate an image)
+5. In the request payload, find the `rpcids` parameter — that's the RPC ID
+6. Update `gflow/api/rpc_ids.py` with the real ID
+Check which IDs are configured:
+```bash
+gflow rpc-ids
+```
+Use raw mode to test discovered IDs:
+```bash
+gflow raw "xYz123" --args '["my prompt", "16:9"]'
+```
+## Commands
+| Command | Description |
+|---------|-------------|
+| `gflow auth` | Authenticate with Google Flow |
+| `gflow auth --status` | Check auth status |
+| `gflow auth --clear` | Clear saved credentials |
+| `gflow generate-image PROMPT` | Generate images (Imagen 4) |
+| `gflow generate-video PROMPT` | Generate videos (Veo 3.1) |
+| `gflow list` | List assets in your library |
+| `gflow get ASSET_ID` | Get asset details |
+| `gflow download ASSET_ID` | Download an asset |
+| `gflow delete ASSET_ID` | Delete an asset |
+| `gflow collections list` | List collections |
+| `gflow collections create NAME` | Create a collection |
+| `gflow collections add COL_ID ASSET_ID` | Add asset to collection |
+| `gflow raw RPC_ID` | Execute raw RPC (discovery mode) |
+| `gflow rpc-ids` | Show configured RPC IDs |
+All commands support `--json` for machine-readable output (ideal for scripts/agents).
+## Environment Variables
+| Variable | Description |
+|----------|-------------|
+| `GFLOW_AUTH_TOKEN` | Auth token (overrides saved credentials) |
+| `GFLOW_COOKIES` | Cookie string (overrides saved credentials) |
+| `GFLOW_CHROME_PATH` | Path to Chrome executable |
+| `GFLOW_DEBUG` | Set to `true` for debug output |
+## For AI Agents / Scripts
+Every command supports `--json` output:
+```bash
+# Generate and get JSON response
+gflow generate-image "a logo" --json | jq '.[0].url'
+# List assets as JSON for processing
+gflow list --type image --json | jq '.[].id'
+# Pipeline: generate, wait, download
+ASSET_ID=$(gflow generate-video "ocean waves" --json | jq -r '.[0].id')
+gflow download "$ASSET_ID" -o waves.mp4
+```
+## How It Works (Same as tmc/nlm)
+1. **Browser Auth**: Extracts Google cookies from Chrome/Brave/Edge profiles using `browser_cookie3`, then fetches the XSRF token from the Flow page HTML
+2. **BatchExecute Protocol**: Encodes RPC calls into Google's `batchexecute` wire format — form-encoded POST with nested JSON arrays, SAPISIDHASH authorization header
+3. **Response Decoding**: Parses Google's chunked response format (byte-count prefixed JSON chunks with `wrb.fr` markers and multi-layer JSON encoding)
+4. **Retry Logic**: Exponential backoff for transient errors (429, 500, 502, 503, 504)
+## Project Structure
+```
+gflow-py/
+├── pyproject.toml              # Package config & dependencies
+├── README.md
+├── gflow/
+│   ├── __init__.py
+│   ├── auth/
+│   │   ├── __init__.py
+│   │   └── browser_auth.py     # Cookie extraction & Selenium login
+│   ├── batchexecute/
+│   │   ├── __init__.py
+│   │   └── client.py           # Google BatchExecute protocol
+│   ├── api/
+│   │   ├── __init__.py
+│   │   ├── client.py           # FlowClient (high-level API)
+│   │   ├── models.py           # Pydantic models (Asset, Collection, etc.)
+│   │   └── rpc_ids.py          # RPC endpoint IDs (fill these in!)
+│   └── cli/
+│       ├── __init__.py
+│       └── main.py             # Click CLI commands
+└── tests/
+    ├── __init__.py
+    └── test_batchexecute.py    # Unit tests
+```
+## License
+MIT

package/skills/short-maker/scripts/google-flow-cli/docs/specs/PROJECT.md ADDED Viewed

@@ -0,0 +1,12 @@
+# Project Vision: GoogleFlowCli
+GoogleFlowCli (gflow) is a streamlined CLI-based workflow and pipeline for generating AI videos systematically, optimizing for cost (credits) and consistency.
+## Target Audience
+Video creators, AI filmmakers, and developers needing a structured bulk generation framework with separate audio pipelines.
+## Success Metrics
+- Stable, consistent video outputs based on predictable image storyboards.
+- High cost efficiency by validating free image scenes before running 20-credit video generations.
+- Automated, seamless merging of generated high-quality voiceovers using the LucyLab pipeline.
+- Secure token handling and artifact management.