agentreel 0.3.4 → 0.3.5

package/bin/agentreel.mjs

@@ -100,13 +100,14 @@ function ensureBrowserDeps() {
   });
 }
 
-function recordCLI(command, workDir, context) {
+function recordCLI(command, workDir, context, guidelines) {
   const python = findPython();
   const script = join(ROOT, "scripts", "cli_demo.py");
   const outFile = join(tmpdir(), "agentreel-cli-demo.cast");
 
   const args = [script, command, workDir, outFile];
   if (context) args.push(context);
+  if (guidelines) args.push(guidelines);
 
   console.error(`Agent planning CLI demo for: ${command}`);
   execFileSync(python, args, { stdio: ["ignore", "inherit", "inherit"], env: process.env });
@@ -133,7 +134,7 @@ function browserEnv() {
   return { ...process.env, PLAYWRIGHT_BROWSERS_PATH: browsersDir };
 }
 
-function recordBrowser(url, task, authState) {
+function recordBrowser(url, task, authState, guidelines) {
   const python = findPython();
   const script = join(ROOT, "scripts", "browser_demo.py");
   const outFile = join(tmpdir(), "agentreel-browser-demo.mp4");
@@ -141,6 +142,7 @@ function recordBrowser(url, task, authState) {
   console.error(`Agent demoing browser app: ${url}`);
   const args = [script, url, outFile, task];
   if (authState) args.push("--auth", authState);
+  if (guidelines) args.push("--guidelines", guidelines);
   execFileSync(python, args, {
     stdio: ["ignore", "inherit", "inherit"],
     env: browserEnv(),
@@ -425,7 +427,7 @@ async function main() {
 
   if (demoCmd) {
     console.error("Step 1/3: Recording CLI demo...");
-    const castPath = recordCLI(demoCmd, process.cwd(), prompt);
+    const castPath = recordCLI(demoCmd, process.cwd(), prompt, flags.guidelines);
 
     console.error("Step 2/3: Extracting highlights...");
     const highlightsPath = extractHighlightsFromCast(castPath, prompt, flags.guidelines);
@@ -451,7 +453,7 @@ async function main() {
 
     ensureBrowserDeps();
     console.error("Step 1/3: Recording browser demo...");
-    const videoPath = recordBrowser(demoURL, task, flags.auth);
+    const videoPath = recordBrowser(demoURL, task, flags.auth, flags.guidelines);
 
     // Copy video to Remotion public dir so it can be served
     const publicDir = join(ROOT, "public");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentreel",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Turn your web apps and CLIs into viral clips",
   "bin": {
     "agentreel": "./bin/agentreel.mjs"

package/scripts/browser_demo.py

@@ -30,11 +30,13 @@ def find_claude():
     return "claude"
 
 
-def generate_playwright_script(url, task):
+def generate_playwright_script(url, task, guidelines=""):
     """Use claude CLI to generate a Playwright demo script."""
+    guidelines_part = f"IMPORTANT guidelines: {guidelines}. " if guidelines else ""
     prompt = (
         f"Generate a Playwright Python async function that demos a web app at {url}. "
         f"Task: {task}. "
+        f"{guidelines_part}"
         f"The function signature is: async def demo(page). "
         f"Navigate to the URL, wait for load, interact with key features — "
         f"click buttons, fill forms, scroll. Take about 20 seconds total. "
@@ -124,12 +126,12 @@ def extract_highlights(video_path, task):
     return highlights
 
 
-async def record_browser_demo(url, task, output_path, auth_state=None):
+async def record_browser_demo(url, task, output_path, auth_state=None, guidelines=""):
     """Generate and run a Playwright demo with video recording."""
     from playwright.async_api import async_playwright
 
     print(f"Generating demo script for {url}...", file=sys.stderr)
-    script_code = generate_playwright_script(url, task)
+    script_code = generate_playwright_script(url, task, guidelines)
     print(f"Script ready ({len(script_code)} chars)", file=sys.stderr)
 
     video_dir = tempfile.mkdtemp()
@@ -269,12 +271,16 @@ if __name__ == "__main__":
         # Parse remaining args: [task] [--auth <state_file>]
         task = "Explore the main features"
         auth_state = None
+        guidelines = ""
         i = 3
         while i < len(sys.argv):
             if sys.argv[i] == "--auth" and i + 1 < len(sys.argv):
                 auth_state = sys.argv[i + 1]
                 i += 2
+            elif sys.argv[i] == "--guidelines" and i + 1 < len(sys.argv):
+                guidelines = sys.argv[i + 1]
+                i += 2
             else:
                 task = sys.argv[i]
                 i += 1
-        asyncio.run(record_browser_demo(url, task, output, auth_state=auth_state))
+        asyncio.run(record_browser_demo(url, task, output, auth_state=auth_state, guidelines=guidelines))

package/scripts/cli_demo.py

@@ -33,12 +33,14 @@ def find_claude():
     return "claude"
 
 
-def generate_demo_plan(command: str, context: str) -> list[dict]:
+def generate_demo_plan(command: str, context: str, guidelines: str = "") -> list[dict]:
     """Use claude CLI to plan a demo sequence."""
+    guidelines_block = f"\n\nIMPORTANT guidelines you MUST follow:\n{guidelines}" if guidelines else ""
+
     prompt = f"""You are planning a terminal demo for a CLI tool. The tool is invoked with: {command}
 
 Context about what this tool does:
-{context}
+{context}{guidelines_block}
 
 Generate a JSON array of demo steps. Each step is an object with:
 - "type": "command" (run a shell command)
@@ -289,9 +291,10 @@ if __name__ == "__main__":
     workdir = sys.argv[2]
     output = sys.argv[3]
     context = sys.argv[4] if len(sys.argv) > 4 else ""
+    guidelines = sys.argv[5] if len(sys.argv) > 5 else ""
 
     print(f"Planning demo for: {command}", file=sys.stderr)
-    steps = generate_demo_plan(command, context)
+    steps = generate_demo_plan(command, context, guidelines)
     print(f"Generated {len(steps)} steps:", file=sys.stderr)
     for s in steps:
         print(f"  $ {s['value']}  — {s.get('description', '')}", file=sys.stderr)
@@ -302,7 +305,7 @@ if __name__ == "__main__":
     # Extract highlights from the recording
     highlights_path = output.replace(".cast", "-highlights.json")
     print("Extracting highlights...", file=sys.stderr)
-    highlights = extract_highlights(output, context)
+    highlights = extract_highlights(output, context, guidelines)
     with open(highlights_path, "w") as f:
         json.dump(highlights, f, indent=2)
     print(f"Saved {len(highlights)} highlights to: {highlights_path}", file=sys.stderr)