Proactive Runner 🚀

AI-Driven Adaptive Automation Runner Platform

Stop burning tokens on tasks a script can handle.

What is Proactive Runner?

Proactive Runner is a CLI tool + Docker runner platform that intelligently automates complex workflows using a two-step execution model:

1. Pipeline Construction — AI Agent (via agent-browser) researches your goal, explores the web, and builds a complete execution Pipeline
2. Pipeline Execution — The Pipeline runs in an isolated Docker container, mixing Pre-built Pipes and AI Nodes

Architecture

User Goal (natural language)
    │
    ▼
[AI Agent constructs Pipeline via agent-browser]
    │
    ▼
Pipeline = Pipes + Nodes
    │
    ├── 🔧 Pre-built Pipe (captcha, proxy, transform...)
    ├── 🧠 AI Node (browse, extract, judge)
    ├── 🔧 Pre-built Pipe  
    ├── 🧠 AI Node
    └── 🔧 Pre-built Pipe (export)
    │
    ▼
[Execute in Docker container]
    │
    ▼
Results

Pre-built Pipes (infrastructure, deterministic)

Pipe	Function
captcha-solver	Solve CAPTCHAs (reCAPTCHA, hCaptcha)
proxy-rotate	Rotate proxies for anti-detection
anti-detect	Browser fingerprint management
cookie-manager	Cookie/session management
email-verify	Email verification via API
sms-receive	SMS verification codes
transform	Data transformation (JSON, XML, CSV)
csv-export	Export results
screenshot	Capture & archive
retry	Auto-retry with backoff
rate-limit	Throttling
notify	Notifications (Telegram, Slack)
storage	Database/file read-write
wait	Delays, conditional waits

AI Nodes (intelligent, agent-browser driven)

Every Node is an AI Agent operating through agent-browser + Patchright:

• Navigate and browse web pages
• Fill forms, click buttons, handle dynamic UIs
• Extract data from unstructured pages
• Make judgment calls
• Handle unexpected situations

Backing LLMs: Claude Code, OpenClaw, Gemini

CLI

proactive plan "Find CTOs of 50 YC S25 companies"   # AI builds pipeline
proactive run                                         # Run locally (Docker)
proactive run --cloud                                 # Run on cloud runner
proactive status                                      # Check progress
proactive pipes                                       # List pre-built pipes
proactive nodes                                       # List AI nodes
proactive templates                                   # Browse templates

Run Locally or in the Cloud

• Local: Free. Runs Docker on your machine.
• Cloud: Paid. Runs on Proactive Runner's Docker cluster. No setup needed.

Tech Stack

• CLI: Node.js + TypeScript
• Browser Engine: Patchright (anti-detection Playwright fork)
• AI Agent: agent-browser (Vercel Labs fork)
• Execution: Docker containers (isolated per pipeline)
• LLM: Claude / Gemini / OpenClaw

Links

• 🌐 Website: proactive.run
• 📋 Product Spec: PRODUCT_SPEC.md
• 🧠 agent-browser fork: kknd0/agent-browser
• 🛡️ Patchright fork: kknd0/patchright

License

MIT

---

Built by Lizi Li • @LiZi32868