axuse

Accessibility-first browser & computer use for AI agents — one MCP server for every harness (Codex, Claude Code, OpenCode, Antigravity). Instruments the DOM/acc

What is axuse?

Accessibility-first browser & computer use for AI agents — one MCP server for every harness (Codex, Claude Code, OpenCode, Antigravity). Instruments the DOM/accessibility tree via CDP instead of screenshot loops: diffed snapshots, stable element refs, trusted input, typed errors. Zero dependencies

Overview of axuse

What it is

axuse is an accessibility-first browser and computer use tool for AI agent harnesses. It provides a single MCP server that works with Codex, Claude Code, OpenCode, Antigravity, or any MCP-capable host. Instead of using screenshot loops, axuse instruments the DOM and accessibility tree via the Chrome DevTools Protocol (CDP). It uses diffed snapshots, stable element references, trusted input, and typed errors. The tool has zero dependencies and requires Node.js 22 or later.

Key features

  • Instruments the DOM/accessibility tree via CDP instead of screenshot loops
  • Diffed snapshots, stable element refs, trusted input, typed errors
  • Zero dependencies (Node ≥ 22)
  • Windows desktop driver verified; macOS desktop control available as explicit opt-in with native TCC permission checks; Linux desktop control over X11/XWayland
  • Server mode for headless Ubuntu servers: boots a private Xvfb and runs Chrome fully headed
  • Environment variables for persona coherence (timezone, language, proxy, display size, etc.)
  • Benchmark on 16 server-scored browser tasks: 28/28 passed, median time 17 seconds, 4.7M tokens, median 5 tool calls

Use cases

axuse is designed for AI agents that need to interact with web browsers and computer desktops. It can be used in harnesses such as Codex, Claude Code, OpenCode, and Antigravity. Typical tasks include opening websites, finding and clicking elements, filling forms, solving captchas, and navigating multi-step workflows.

Getting started

Prerequisites: Node.js 22+ and a Chromium-family browser (Chrome, Edge, Chromium, or Chrome for Testing). On a bare server, you can run node src/cli.js install-browser to provision a pinned Chrome for Testing.bashgit clone https://github.com/ctoldigital/axuse.gitcd axusenode src/cli.js doctor # finds a browser, launches it, takes a snapshotFor a daily Chrome/Edge session, use the guided bridge setup:bashnode src/cli.js setup --browser chrome --harness codexAfter loading the extension, verify the connection:bashnode src/cli.js bridge verifyAdd axuse to your harness (use your absolute path to src/cli.js):bash# Codexcodex mcp add axuse -- node /abs/path/axuse/src/cli.js mcp# Claude Codeclaude mcp add --scope user axuse -- node /abs/path/axuse/src/cli.js mcpThen ask the agent to perform browser tasks.

License and pricing

axuse is open source (pricing_type: open_source). The license is not stated in the repository metadata.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ctoldigitalaxuse.svg)](https://yunodb.com/tools/ctoldigitalaxuse?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ctoldigitalaxuse?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ctoldigitalaxuse.svg" alt="Featured on YunoDB" height="20"></a>