Files
actionbook__actionbook/docs/index.mdx
asensagent a42d58d92b docs: comprehensive audit fix for CLI 1.0.0–1.4.2 (#520)
* docs: comprehensive audit fix for CLI 1.0.0–1.4.2

Align docs/ and skills/ with CLI actual state after 1.0.0→1.4.2 changes.

P0 — broken examples fixed:
- quickstart.mdx: add --session/--tab, use start+goto instead of open
- index.mdx: replace search→get→operate flow with start→snapshot→automate
- api-reference/cli.mdx: remove search/get sections, add full browser
  command reference with --session/--tab on all commands
- guides/browser.mdx: add --session/--tab to Local Mode examples,
  replace search→get recommended workflow with snapshot-based workflow
- guides/cli-and-skills.mdx: add --session/--tab, update skill workflow
  from search→get→operate to start→snapshot→automate

P1 — missing flags and commands:
- command-reference.md: add --provider/-p, --stealth/--no-stealth,
  --header, --session to start; add --wait-until to goto; add --by-ref
  to select; add --no-isolate, pre-context fields, structured error
  details to eval; add --screenshot-format, --selector to screenshot;
  add hermes target and --browser to setup; remove --executable-path
- SKILL.md: add missing commands to Observation row (viewport, attr,
  attrs, box, styles, describe, state, inspect-point, pdf) and
  Interaction row (focus, drag, upload, eval, mouse-move,
  cursor-position); add cloud provider workflow section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: restore search/get references per review feedback

Keep actionbook search and actionbook get sections in docs — they will
be adjusted later. Restores search/get to api-reference/cli.mdx,
index.mdx, browser.mdx recommended workflow, and cli-and-skills.mdx
core commands and skill workflow. The --session/--tab fixes on browser
commands remain.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add select diagnostic output to command-reference

Document that `browser select` now returns structured diagnostics
(available values, visible texts, match mode, total count) when an
option is not found (PR #521).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-14 15:18:28 +08:00

107 lines
3.4 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: 'Introduction'
description: 'Make agents browse 10× faster with unbreakable resilience.'
---
Actionbook gives LLMs up-to-date DOM structure and action guides. Install the CLI and start automating in minutes.
<video
controls
className="w-full aspect-video rounded-xl"
src="/actionbook-demo.mp4"
/>
_See how Actionbook enables an agent to complete an Airbnb search task 10× faster._
## Why Actionbook?
### <Icon icon="xmark" color="#ef4444" /> 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
### <Icon icon="check" color="#22c55e" /> 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
## How It Works
<Steps>
<Step title="Search for Actions" icon="magnifying-glass">
Find available actions for any website using the CLI (`actionbook search
"airbnb login"`).
</Step>
<Step title="Get Action Details" icon="book">
Retrieve the full action manual with precise selectors and step-by-step
instructions (`actionbook get "google.com:/:default"`).
</Step>
<Step title="Launch & Execute" icon="bullseye">
Start a browser session and let your agent execute actions with confidence —
no guessing, no hallucinations (`actionbook browser start --set-session-id s1`,
then `actionbook browser goto "https://www.google.com" --session s1 --tab t1`).
</Step>
</Steps>
## Integration Options
<Columns cols={3}>
<Card title="CLI" icon="terminal" href="/quickstart">
Default mode — launches browser automatically
</Card>
<Card title="Browser Automation" icon="window" href="/guides/browser">
Isolated or extension — two modes for AI agents
</Card>
<Card title="MCP Server" icon="server" href="/guides/mcp-server">
Integrate with Cursor, Claude Code, VS Code, etc.
</Card>
</Columns>
## Quick Start
<Columns cols={2}>
<Card title="Quickstart Guide" icon="rocket" href="/quickstart">
Get started in under 2 minutes
</Card>
<Card title="API Reference" icon="code" href="/api-reference/cli">
CLI commands and API documentation
</Card>
</Columns>
## Community
<Columns cols={3}>
<Card
title="GitHub"
icon="github"
iconType="brands"
href="https://github.com/actionbook/actionbook"
>
Star us and contribute
</Card>
<Card
title="Discord"
icon="discord"
iconType="brands"
href="https://actionbook.dev/discord"
>
Get help and share your agents
</Card>
<Card
title="X / Twitter"
icon="x-twitter"
iconType="brands"
href="https://x.com/ActionbookHQ"
>
Product updates and announcements
</Card>
</Columns>