Skip to main content

​
Install

npm install -g @basemachina/agentic-browser-cli

​
Commands

CommandDescription
generateGenerate a runbook YAML by AI-driven browser exploration
executeExecute a runbook YAML
fix-runbookApply repair suggestions from an execution report to a runbook

​
Global options

OptionDescription
--version, -vShow version number
--help, -hShow help

​
Basic usage

​
Generate a runbook

npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com/login" \
  --goal "Log in and export dashboard data" \
  --output ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
Instead of passing --model and --model-provider on every command, you can set defaults via environment variables:
export AI_MODEL_ID="claude-sonnet-4-6"
export AI_MODEL_PROVIDER="anthropic"

​
Execute a runbook

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic

​
Self-heal mode

Validate a runbook with aggressive retry and generate repair suggestions: 
npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-export.yaml \
  --self-heal

​
Apply fixes

Apply AI-generated repair suggestions to update a broken runbook: 
npx @basemachina/agentic-browser-cli fix-runbook -- \
  --runbook ./login-export.yaml \
  --report ./report.md

​
AI provider configuration

By default, Agentic Browser uses Anthropic Claude. Set the API key: 
export ANTHROPIC_API_KEY="sk-ant-..."
To use a different provider, pass --model-provider and the corresponding environment variable:
ProviderFlagEnvironment variable
Anthropic (default)--model-provider anthropicANTHROPIC_API_KEY
OpenAI--model-provider openaiOPENAI_API_KEY
OpenAI-compatible--model-provider openai-compatibleOPENAI_COMPATIBLE_BASE_URL, OPENAI_COMPATIBLE_API_KEY
Google AI Studio--model-provider googleGOOGLE_GENERATIVE_AI_API_KEY
Azure OpenAI--model-provider azureAZURE_RESOURCE_NAME, AZURE_API_KEY
Amazon Bedrock--model-provider bedrockAWS_REGION, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
Google Vertex AI--model-provider vertexGOOGLE_VERTEX_PROJECT, GOOGLE_VERTEX_LOCATION

​
API key (Plan tiers)

Unlock advanced features by setting an API key: 
export AGENTIC_BROWSER_API_KEY="agb-eyJ..."
Or pass it per-command: 
npx @basemachina/agentic-browser-cli execute -- --runbook ./flow.yaml --api-key "agb-eyJ..."
See Plan tiers for feature details.