kachilu-browser

name	kachilu-browser
description	Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, logging in to sites, posting to social apps, handling CAPTCHA workflows, or automating browser actions. Load the core guide to choose between host-provided sessions, MCP tools, and CLI commands.
allowed-tools	Bash(npx kachilu-browser:*), Bash(kachilu-browser:*)
hidden	true

kachilu-browser

Browser automation CLI for AI agents. Chrome/Chromium via CDP with accessibility-tree snapshots and compact @eN element refs.

Install: npm i -g kachilu-browser && kachilu-browser install

Start Here

This file is a discovery stub, not the usage guide. Before running any kachilu-browser command, load the actual workflow content from the CLI:

kachilu-browser skills get core             # start here: workflows, control-plane routing, CAPTCHA, troubleshooting
kachilu-browser skills get core --full      # include references and templates when needed

The CLI serves skill content that matches the installed version, so instructions do not drift when the package is upgraded. The core guide contains the Kachilu human-like interaction defaults, control-plane routing rules, rich composer safeguards, CAPTCHA workflow, and the command reference.

If the host already provides a pre-attached browser session, CDP endpoint, session ref file, or explicit kachilu-browser --session ... --cdp ... command, use that host-provided session through the CLI. Do not switch to MCP prepare_workspace or auto-connect unless the core guide says that no host-provided session is available.

For MCP hosts such as OpenClaw, keep using the same prepared workspace session across related browser work in one user request, even when moving between sites such as LinkedIn and X. The site hint is for routing only. Do not close the workspace between those steps unless the user explicitly wants cleanup. If the daemon still exists but the browser connection is gone, treat that workspace as stale and reconnect instead of reusing it.

Critical Fallback

If an element-targeted click fails but the visible cursor is already on the intended button or control, take a screenshot/capture and confirm the cursor is on target. Then click at the current cursor position:

kachilu-browser mouse down left
kachilu-browser mouse up left
kachilu-browser snapshot -i

Use this after visual confirmation instead of repeating the same failing ref or locator click.