mcfn
143ba43e8b
SPA frameworks (React Router, Vue Router, Next.js) require a prior mouseMoved event to establish pointer hover state before the click event synthesizes correctly. Without it, the router's click listener never fires and the URL remains unchanged (url_changed: false). Add a single mouseMoved dispatch at (x, y) with button=none before the existing mousePressed/mouseReleased loop — matches Playwright's standard click implementation. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Actionbook
Browser Action Engine for AI Agents
Actionbook provides up-to-date action manuals and DOM structure,
so your agent operates any website instantly without guessing.
Table of Contents
Why Actionbook?
❌ Without Actionbook
Building reliable browser agents is difficult and expensive:
- Slow Execution: Agents waste time parsing full HTML pages to find elements.
- High Token Costs: Sending entire DOM trees to LLMs consumes massive context windows.
- Brittle Selectors: Updates to website UIs break hardcoded selectors and agent logic immediately.
- Hallucinations: LLMs often guess incorrect actions when faced with complex, unstructured DOMs.
✅ With Actionbook
Actionbook places up-to-date action manuals with the relevant DOM selectors directly into your LLM's context.
- 10x Faster: Agents access pre-computed "Action manuals" to know exactly what to do without exploring.
- 100x Token Savings: Instead of whole HTML page, agents receive only related DOM elements in concise, semantic JSON definitions.
- Resilient Automation: Action manuals are maintained and versioned. If a site changes, the manual is updated, not your agent.
- Universal Compatibility: Works with any LLM (OpenAI, Anthropic, Gemini) and any AI operator framework.
See how Actionbook enables an agent to complete an Airbnb search task 10x faster.
https://github.com/user-attachments/assets/9f896fe7-296a-44b3-8592-931a099612de
Quick Start
Get started with Actionbook in under 2 minutes:
Step 1: Install the CLI
macOS / Linux
curl -fsSL https://actionbook.dev/install.sh | bash
Windows (PowerShell)
irm https://actionbook.dev/install.ps1 | iex
The Rust-based CLI uses your existing system browser (Chrome, Brave, Edge, Arc, Chromium), so no extra browser install step is required.
Step 2: Use with any AI Agent
When working with any AI coding assistant (Claude Code, Cursor, etc.), add this to your prompt:
Use Actionbook to understand and operate the web page.
The agent will automatically use the CLI to fetch action manuals and execute browser operations.
Step 3 (Optional): Add the Skill
For enhanced agent integration, add the Actionbook skill:
npx skills add actionbook/actionbook
Installation
macOS / Linux
curl -fsSL https://actionbook.dev/install.sh | bash
Windows
irm https://actionbook.dev/install.ps1 | iex
npm
npm install -g @actionbookdev/cli
Setup
actionbook setup
For more install options (Homebrew, from source) and upgrade instructions, see the Installation Guide.
The CLI is all you need to get started. For advanced use cases, Actionbook also offers an MCP Server and JavaScript SDK.
Examples
Explore real-world examples in the Examples Documentation.
Available Tools
Actionbook provides tools for searching and retrieving action manuals. See the CLI Reference for the full command list. If you're using the MCP integration, see the MCP Tools Reference.
Documentation
For comprehensive guides, API references, and tutorials, visit our documentation site:
Stay tuned
We move fast. Star Actionbook on Github to support and get latest information.
Join the community:
- Chat with us on Discord - Get help, share your agents, and discuss ideas
- Follow @ActionbookHQ on X - Product updates and announcements
Contributing
- Read the Contributing Guide - See repository setup, package layout, and validation workflows for the public repo.
- Request a Website - Suggest websites you want Actionbook to index.
- Join the Waitlist - We are currently in private beta. Join if you are interested in contributing or using Actionbook.
License
See LICENSE for the license details.