Getting Started

Onboarding

Reduck lets you control a real Chrome browser from your terminal or code. Send a natural-language prompt, and Reduck executes it — navigating pages, filling forms, clicking buttons, extracting data.

Step 1: Create your account

Go to reduck.ai and sign up with your email (magic link) or Google/Microsoft OAuth.

Step 2: Install the Chrome extension

  1. From the dashboard, click “Install Extension” to download the .zip
  2. In Chrome, go to chrome://extensions
  3. Enable Developer mode (toggle top-right)
  4. Click “Load unpacked” → select the unzipped folder
  5. The Reduck icon appears in your toolbar

Allow notifications: Chrome may ask — click Allow. This is required for the runner to wake up your extension.

Step 3: Pair your device

  1. Click the Reduck icon in the Chrome toolbar
  2. The side panel opens and shows your device info

Your browser is now a paired device. The runner can send it work via web push.

Step 4: Install the CLI

npm install -g @reduck-ai/cli

Step 5: Authenticate

# OAuth (recommended — opens browser)
reduck login

# Or use an API key (generate one from Account → API Keys)
export REDUCK_API_KEY="rk_..."

Step 6: Select your device

reduck devices   # lists your paired browsers, saves the selection

Step 7: Run your first automation

reduck -q "Go to google.com and search for 'best coffee in Paris'"

Reduck streams progress to your terminal and prints the final result.

Checklist

  • Account created on reduck.ai
  • Chrome extension installed and loaded
  • Notifications allowed for Chrome
  • Device paired (side panel opened)
  • CLI installed
  • Authenticated (reduck login or REDUCK_API_KEY set)
  • Device selected via reduck devices
  • First run executed successfully

Next steps