glidercli

Browser automation CLI with autonomous loop execution.

ToC

About
Install
Usage
The loop
Task files
Commands
Roadmap
Tools
Contact

About

Control Chrome from terminal. Run YAML tasks. Loop until complete (Ralph Wiggum pattern).

• CDP-based - Direct Chrome DevTools Protocol (CDP) control
• YAML tasks - Define automation steps declaratively
• Autonomous loops - Run until completion marker found
• Safety guards - Max iterations, timeout, exponential backoff

Install

One-liner:

npm i -g glidercli && open "https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj"

Then:

glider install    # start daemon (runs forever, auto-restarts)
glider connect    # connect to Chrome

Update anytime:

glider update     # pulls latest from npm

Requirements

1. Node 18+

2. Glider Chrome extension - Install from Chrome Web Store

Usage

glider connect                   # connect to browser
glider status                    # check connection
glider goto "https://x.com"      # navigate
glider eval "document.title"     # run JS
glider run task.yaml             # execute task file
glider loop task.yaml -n 50      # autonomous loop

Daemon

The daemon keeps the relay server running 24/7. Auto-restarts on crash.

glider install     # install daemon (runs at login)
glider uninstall   # remove daemon

Logs: ~/.glider/daemon.log

The loop

The loop (or ralph) command runs your task repeatedly until:

• Completion marker found (LOOP_COMPLETE or DONE)
• Max iterations reached
• Timeout hit

glider loop scrape-feed.yaml -n 100 -t 3600
glider ralph task.yaml  # same thing

Safety: max iterations, timeout, exponential backoff on errors, state persistence.

Task files

name: "Get timeline"
steps:
  - goto: "https://x.com/home"
  - wait: 3
  - eval: "document.querySelectorAll('article').length"
  - screenshot: "/tmp/timeline.png"

Commands

Setup

Command	What
glider install	Install daemon (runs at login)
glider uninstall	Remove daemon
glider update	Update to latest version
glider connect	Connect to browser
glider status	Server/extension/tab status
glider test	Run diagnostics

Navigation

Command	What
glider goto <url>	Navigate
glider eval <js>	Execute JavaScript
glider click <sel>	Click element
glider type <sel> <text>	Type into input
glider screenshot	Capture page
glider html <sel>	Get element HTML
glider title	Get page title
glider text	Get page text

Multi-tab

Command	What
glider fetch <url>	Fetch URL with browser session (authenticated)
glider spawn <urls...>	Open multiple tabs
glider extract [opts]	Extract content from all connected tabs
glider explore <url>	Crawl site, capture links/network

Automation

Command	What
glider run <file>	Run YAML task
glider loop <file>	Autonomous loop
glider ralph <file>	Alias for loop

Roadmap

• CDP-based browser control via relay
• YAML task file execution
• Ralph Wiggum autonomous loop pattern
• Daemon mode (auto-start, auto-restart)
• macOS notifications
• Multi-tab orchestration (spawn, extract)
• Authenticated fetch via browser session
• Site exploration/crawling
• Chrome Web Store extension publish
• Linux support
• Windows support
• Headless mode
• Task chaining (output of one -> input of next)
• Built-in scraping templates
• Session recording/playback
• AI-assisted task generation
• Web dashboard for monitoring loops

Tools

Contact