Cognitive browser automation that thinks like your users. Simulate real user cognition with abandonment detection, constitutional safety, chaos engineering, and UX friction discovery.
npm install cbrowser> The browser automation that thinks. After 640+ tool invocations across rigorous stress testing on 11 real-world sites, CBrowser earned a Grade A+ assessment—19 issues tracked, 19 fixed, zero open bugs. View Full Assessment →
Built for AI agents. Trusted by humans. The only browser automation that asks: "Will a confused first-timer complete this task—and exactly when will they give up?"
---
31 of 33 tools graded A or above (5 at A+). After 640+ tool invocations across 11 real-world sites including Spotify, Airbnb, and MDN:
| Capability | Status | Why It Matters |
|------------|--------|----------------|
| Natural Language Tests | ⭐ Best-in-class | Write tests in plain English. 10-step E2E flows run 100% stable. |
| Cognitive User Simulation | 🔬 Novel | 12 research-backed traits model real human behavior—not just clicks. |
| Empathy Accessibility Audits | 🔬 Novel | Simulate users with tremors, low vision, ADHD. No competitor offers this. |
| Self-Healing Selectors | ✅ Production-ready | ARIA-first with 0.8+ confidence gating. Handles DOM changes automatically. |
| Constitutional AI Safety | 🔬 Novel | Risk-classified actions prevent autonomous agents from doing damage. |
| 45 MCP Tools | ✅ Production-ready | Full Claude integration—local and remote servers. |
---
Traditional browser automation answers one question: "Does this button click?"
CBrowser answers the question that actually matters: "Will a confused first-timer on a slow connection find this button—and will they give up before they do?"
Built on Playwright with cognitive user simulation, constitutional AI safety, and research-backed behavioral models, CBrowser is the only testing framework designed for the AI agent era.
---
| Challenge | Traditional Tools | CBrowser |
|-----------|-------------------|----------|
| User behavior | Simulates clicks and keystrokes | Simulates human cognition—patience decay, frustration accumulation, decision fatigue |
| Abandonment prediction | Fails when elements don't exist | Predicts when users give up before they do |
| AI agent safety | No guardrails for autonomous agents | Constitutional AI safety—risk-classified actions with verification gates |
| Selector resilience | Breaks when DOM changes | Self-healing ARIA-first selectors with 0.8+ confidence gating |
| Accessibility testing | WCAG compliance checklists | Disability empathy simulation—experience your site as a user with tremors, low vision, or ADHD |
---
``bash`
npm install cbrowser
npx playwright install chromium
`bashNavigate with intelligent wait detection
npx cbrowser navigate "https://your-site.com"
---
Constitutional AI Safety
AI agents need boundaries. CBrowser classifies every action by risk level:
| Zone | Examples | Behavior |
|------|----------|----------|
| 🟢 Green | Navigate, read, screenshot | Auto-execute |
| 🟡 Yellow | Click buttons, fill forms | Log and proceed |
| 🔴 Red | Submit, delete, purchase | Requires verification |
| ⬛ Black | Bypass auth, inject scripts | Never executes |
An AI agent can freely browse and gather data, but cannot accidentally submit a form, delete records, or make purchases without explicit verification.
---
Cognitive User Simulation
CBrowser models 12 research-backed cognitive traits to simulate how real users think and behave:
| Trait | Research Basis | What It Models |
|-------|---------------|----------------|
| Patience | — | How quickly users abandon on friction |
| Frustration | — | Accumulates with errors, decays with success |
| Decision Fatigue | Baumeister's ego depletion | Users start choosing defaults after too many decisions |
| Dual-Process Thinking | Kahneman (Nobel Prize) | System 1 (fast/automatic) vs System 2 (slow/deliberate) |
| Self-Efficacy | Bandura (1977) | Belief in ability to solve problems; low = faster abandonment |
| Satisficing | Simon (1956) | Accept "good enough" vs. optimize; satisficers decide 50% faster |
| Trust Calibration | Fogg (2003) | Baseline trust affects click-through by 40% |
| Interrupt Recovery | Mark et al. (2005) | Average recovery time 23min; models context preservation |
$3
The simulation stops when a realistic user would give up:
bash
Output from cognitive journey
⚠️ ABANDONED after 8 steps
Reason: Patience depleted (0.08) - "This is taking too long..."
Friction points:
1. Password requirements unclear (step 4)
2. Form validation error not visible (step 6)
`$3
Create research-backed custom personas via interactive questionnaire:
bash
Interactive questionnaire (8 core traits)
npx cbrowser persona-questionnaire startComprehensive questionnaire (all 25 traits)
npx cbrowser persona-questionnaire start --comprehensive --name "my-tester"Look up trait behaviors
npx cbrowser persona-questionnaire lookup --trait patience --value 0.25List all available traits
npx cbrowser persona-questionnaire list-traits
`Each trait maps to research-backed behavioral descriptions with 5 levels (0, 0.25, 0.5, 0.75, 1.0).
---
Natural Language Testing
Write tests in plain English:
txt
Test: Checkout Flow
go to https://your-site.com/products
click "Add to Cart" button
verify page contains "1 item in cart"
click checkout
fill email with "test@example.com"
click "Place Order"
verify url contains "/confirmation"
`bash
npx cbrowser test-suite checkout-test.txt --html
`$3
When tests break due to site changes:
bash
npx cbrowser repair-tests broken-test.txt --auto-apply --verify
`CBrowser analyzes failures, generates alternative selectors, and repairs tests automatically.
---
Visual Testing Suite
$3
Semantic comparison—understands what changed, not just pixel differences:
bash
npx cbrowser ai-visual capture "https://your-site.com" --name homepage
npx cbrowser ai-visual test "https://staging.your-site.com" homepage --html
`$3
bash
Compare Chrome, Firefox, Safari rendering
npx cbrowser cross-browser "https://your-site.com" --htmlTest across mobile, tablet, desktop
npx cbrowser responsive "https://your-site.com" --htmlA/B comparison (staging vs production)
npx cbrowser ab "https://staging.your-site.com" "https://your-site.com" --html
`---
UX Analysis Suite
$3
Analyze any website for AI-agent friendliness:
bash
npx cbrowser agent-ready-audit "https://your-site.com" --html
`Returns:
- Findability score — Can agents locate elements? (ARIA labels, semantic HTML)
- Stability score — Will selectors break? (hidden inputs, overlays)
- Letter grade (A-F) with prioritized remediation and code examples
$3
Run identical cognitive journeys across your site and competitors:
bash
npx cbrowser competitive-benchmark \
--sites "https://your-site.com,https://competitor-a.com,https://competitor-b.com" \
--goal "sign up for free trial" \
--persona first-timer \
--html
`$3
Simulate how users with disabilities experience your site:
bash
npx cbrowser empathy-audit "https://your-site.com" \
--goal "complete signup" \
--disabilities "motor-tremor,low-vision,adhd" \
--html
`Available personas:
, low-vision, cognitive-adhd, dyslexic, deaf, elderly---
MCP Server Integration
CBrowser runs as an MCP server for Claude Desktop and claude.ai.
$3
Public Demo Server (rate-limited, no auth):
https://cbrowser-mcp-demo.wyldfyre.ai/mcp
Deploy your own: see Remote MCP Server Guide
$3
json
{
"mcpServers": {
"cbrowser": {
"command": "npx",
"args": ["cbrowser", "mcp-server"]
}
}
}
`$3
| Category | Tools |
|----------|-------|
| Navigation |
, screenshot, extract, cloudflare_detect, cloudflare_wait |
| Interaction | click, smart_click, fill, scroll |
| Testing | test_suite, repair_tests, flaky_check |
| Visual | visual_baseline, visual_compare, responsive_test, cross_browser_test, ab_compare |
| Cognitive | cognitive_journey_init, cognitive_journey_update_state, compare_personas |
| Persona | persona_questionnaire_get, persona_questionnaire_build, persona_trait_lookup |
| Analysis | hunt_bugs, chaos_test, agent_ready_audit, competitive_benchmark, empathy_audit |
| Stealth | stealth_enable, stealth_disable, stealth_status, stealth_check, stealth_diagnose |---
CI/CD Integration
$3
`yaml
name: CBrowser Tests
on: [pull_request]jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: alexandriashai/cbrowser@v12
with:
test-file: tests/e2e/checkout.txt
sensitivity: strict
`$3
bash
docker run --rm -v $(pwd)/tests:/work/tests ghcr.io/alexandriashai/cbrowser:latest \
test-suite tests/checkout.txt --html
`---
Modular Architecture
Tree-shakeable imports for minimal bundle size:
typescript
// Import specific modules
import { runVisualRegression, runCrossBrowserTest } from 'cbrowser/visual';
import { runNLTestSuite, detectFlakyTests, repairTest } from 'cbrowser/testing';
import { huntBugs, runChaosTest, findElementByIntent } from 'cbrowser/analysis';
import { capturePerformanceBaseline, detectPerformanceRegression } from 'cbrowser/performance';
`---
API Reference
typescript
import { CBrowser } from 'cbrowser';const browser = new CBrowser({
headless: true,
persistent: true, // Maintain cookies between sessions
});
await browser.navigate('https://example.com');
const result = await browser.smartClick('Sign In', {
maxRetries: 3,
minConfidence: 0.8 // v12.0.0: Raised threshold for reliable healing
});
const assertion = await browser.assert("page contains 'Welcome'");
if (!assertion.passed) {
console.error(assertion.message);
}
await browser.close();
`---
Configuration
$3
| Variable | Default | Description |
|----------|---------|-------------|
|
| ~/.cbrowser | Data storage directory |
| CBROWSER_HEADLESS | true | Run headless |
| CBROWSER_BROWSER | chromium | Browser engine |
| CBROWSER_TIMEOUT | 30000 | Default timeout (ms) |
| CBROWSER_PROXY | — | Proxy URL (e.g., http://user:pass@proxy:8080) |
| CBROWSER_PROXY_SERVER | — | Proxy server (alternative to full URL) |
| CBROWSER_PROXY_USERNAME | — | Proxy username (with CBROWSER_PROXY_SERVER) |
| CBROWSER_PROXY_PASSWORD | — | Proxy password (with CBROWSER_PROXY_SERVER) |$3
`bash
npx cbrowser config set-api-key
`---
Examples
| Navigation, extraction, sessions |
| examples/cognitive-journey.ts | Cognitive simulation with personas |
| examples/visual-testing.ts | Visual regression, cross-browser, A/B |
| examples/workflows/ | E2E recipes for common scenarios |
| examples/ci-cd/` | GitHub Actions, GitLab CI setup |---
Business Source License 1.1 (BSL-1.1)
- ✅ Free for non-production use: development, testing, personal projects, evaluation
- ✅ Read, modify, and contribute to the source
- ⚠️ Production use (including production testing pipelines) requires a commercial license
Note: Non-production use means evaluation of CBrowser itself, not using CBrowser as part of a production testing service.
Converts to Apache 2.0 on February 5, 2030.
For commercial licensing: alexandria.shai.eden@gmail.com
---
© 2026 WF Media (Alexandria Eden). All rights reserved.
---
- NPM Package
- GitHub Repository
- Issue Tracker
- A+ Assessment Report
- Remote MCP Server Guide
- Roadmap