# Actionbook

Browser action engine.

- Repository: https://github.com/actionbook/actionbook (1623 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add actionbook/actionbook --skill actionbook -g -a claude-code -y`
Codex: `npx skills add actionbook/actionbook --skill actionbook -g -a codex -y`
Cursor: `npx skills add actionbook/actionbook --skill actionbook -g -a cursor -y`
Gemini CLI: `npx skills add actionbook/actionbook --skill actionbook -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add actionbook/actionbook`

## Description

Browser action engine. Provides up-to-date action manuals for the modern web, operate any website instantly, one tab or dozens, concurrently.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## When to Use This Skill

Activate when the user:
- Needs to do anything on a website ("Send a LinkedIn message", "Book an Airbnb", "Search Google for...")
- Asks how to interact with a site ("How do I post a tweet?", "How to apply on LinkedIn?")
- Wants to fill out forms, click buttons, navigate, search, filter, or browse on a specific site
- Wants to take a screenshot of a web page or monitor changes
- Builds browser-based AI agents, web scrapers, or E2E tests for external websites
- Automates repetitive web tasks (data entry, form submission, content posting)
- Needs to operate multiple websites or tabs concurrently

## How It Works

Actionbook provides **up-to-date action manuals** for the modern web. Action manuals tell agents exactly what to do on a page, no parsing, no guessing.

**Why this matters:**
- **10x faster**, action manuals provide selectors and page structure upfront. No snapshot-per-step loop needed.
- **Accurate**, handles SPAs, streaming components, dropdowns, date pickers, and dynamic content reliably.
- **Concurrent**, stateless architecture with explicit `--session`/`--tab`. Operate dozens of tabs in parallel.

The workflow:
1. **Start** a browser session
2. **Navigate** to the target page
3. **Snapshot** to get the page structure with element refs
4. **Automate** using refs from the snapshot

Run `actionbook <command> --help` for full usage and examples of any command.

## Browser Automation

Every browser command is **stateless**, pass `--session` and `--tab` explicitly. No "current tab", you can run commands on any session/tab in parallel.

### Start a session

```bash
actionbook browser start --set-session-id s1
```

Both `--session` and `--set-session-id` are get-or-create: they reuse a Running session with the given ID, or create one if not found. If `--profile` is passed and does not match the session's bound profile, the command fails with `SESSION_PROFILE_MISMATCH`.

### Core workflow: snapshot, act, wait

The rest: https://github.com/actionbook/actionbook/blob/HEAD/skills/actionbook/SKILL.md