Skip to content
Back to search

auto-browser

Give your AI agent a real browser — with a human in the loop. Open-source MCP-native browser agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/LvcidPsyche/auto-browser with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/LvcidPsyche/auto-browser'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lvcidpsyche--auto-browser/badge.svg)](/listings/lvcidpsyche--auto-browser)

HTML

<a href="/listings/lvcidpsyche--auto-browser"><img src="/api/listings/lvcidpsyche--auto-browser/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

That is enough for local development with the default settings.

Optional:

cp .env.example .env
make doctor

Run `make doctor` from a normal terminal with local Docker access and permission to open localhost sockets.

Open:

- API docs: `http://127.0.0.1:8000/docs` - Operator dashboard: `http://127.0.0.1:8000/dashboard`, which includes the queue of actions waiting on your approval - Visual takeover: `http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale`

All published ports bind to `127.0.0.1` by default.

Prebuilt images

Every release is also published to GHCR, so you can skip the build:

docker compose -f docker-compose.yml -f docker-compose.images.yml up -d

`AUTO_BROWSER_IMAGE_TAG` picks the version: `latest` (the default), a release such as `1.9.1`, or `edge` for the current `main`. The images are linux/amd64, and each carries an SBOM and a build provenance attestation (`gh attestation verify oci://ghcr.io/lvcidpsyche/auto-browser-controller:latest -R LvcidPsyche/auto-browser`). The controller image leaves out the agent CLIs; for `*_AUTH_MODE=cli`, build from source with `INSTALL_AGENT_CLIS=true`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 411 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Auto Browser
  2. [![MCP Toplist](https://mcptoplist.com/badge/glama%2FLvcidPsyche%2Fauto-browser.svg)](https://mcptoplist.com/server/glama%2FLvcidPsyche%2Fauto-browser)
  3. [![CI](https://github.com/LvcidPsyche/auto-browser/actions/workflows/ci.yml/badge.svg)](https://github.com/LvcidPsyche/auto-browser/actions/workflows/ci.yml)
  4. [![PyPI](https://img.shields.io/pypi/v/auto-browser-client?label=PyPI)](https://pypi.org/project/auto-browser-client/)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
  6. [![MCP Server](https://img.shields.io/badge/MCP-server-blue)](./README.md)
  7. [![Local First](https://img.shields.io/badge/local--first-0ea5e9)](./README.md)
  8. [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/LvcidPsyche/auto-browser?quickstart=1)
  9. <a href="https://glama.ai/mcp/servers/LvcidPsyche/auto-browser">
  10. <img src="https://glama.ai/mcp/servers/LvcidPsyche/auto-browser/badge" alt="Auto-Browser on Glama: grade A for license, quality, and maintenance" width="420">
  11. </a>
  12. ![Auto Browser demo](docs/assets/demo.gif)
  13. > **Give your AI agent a real browser, with a human in the loop.**
  14. Auto Browser is an MCP-native browser control plane for authorized workflows. It gives MCP clients, LLM agents, and operators a shared Playwright browser with human takeover, reusable auth profiles, approvals, audit trails, and local-first deployment.
  15. Works with:
  16. - Claude Code, Codex (CLI, IDE extension, and app), Google Antigravity, Cursor, and VS Code,
  17. connected directly over HTTP
  18. - Claude Desktop, through the bundled stdio bridge
  19. - any MCP client that can talk HTTP or stdio
  20. - direct REST callers when you want curl-first control
  21. ## Why Auto Browser
  22. - **MCP-native from day one.** The browser surface is already packaged as an MCP server instead of bolted on after the fact.
  23. - **Human takeover when the web gets brittle.** noVNC keeps the same live session available when a person needs to step in.
  24. - **Login once, reuse later.** Save named auth profiles and reopen fresh sessions that are already signed in.
  25. - **Local-first by default.** Run the full stack on your own box with Docker Compose, or use Codespaces for a quick hosted demo.
  26. - **Safety rails built in.** Approvals, operator identity, PII scrubbing, Witness receipts, and policy presets are all part of the product surface.
  27. - **Evidence you can hand to someone else.** Witness receipt chains are Ed25519-signed, and an exported bundle verifies with [`scripts/verify_witness_bundle.py`](./scripts/verify_witness_bundle.py) — which imports nothing from this project, so a recipient need not run or trust this controller to check it. The signing key sits beside the receipts, so for evidence that survives a compromised box, pin a head hash you recorded earlier or ship the receipts off the box ([details](./docs/deployment.md#witness-receipts-what-a-signature-proves)).
  28. - **We audit ourselves in public.** [`docs/audits/2026-08-execution-audit.md`](./docs/audits/2026-08-execution-audit.md) documents an adversarial audit of this repo that found safety controls which reported success while doing nothing, with reproductions, the fixes, and the gates that close the class.
  29. - **Governed skill induction.** Verified browser traces can become staged skill candidates with provenance that is signed when a mesh identity is configured — and checked on read, not just produced — plus verifier adapters and review-only graduation — agents that prove they can repeat themselves correctly, not just act once.
  30. ## Good Fits
  31. - internal dashboards and admin tools
  32. - operator-assisted QA and browser debugging
  33. - login-once, reuse-later account workflows
  34. - brittle sites where a human may need to recover the flow
  35. - MCP-powered agent workflows that need a real browser, not just HTML fetches
  36. ## Not the Goal
  37. - CAPTCHA solving
  38. - unauthorized scraping or account automation
  39. - deceptive identity shaping or bypass tooling
  40. ## What You Get
  41. | Browser Control | Operator Safety | Deployment and Integration |
  42. | --- | --- | --- |
  43. | Playwright-backed sessions with screenshots, DOM summaries, OCR excerpts, tab controls, downloads, and network inspection | approval gates, operator identity headers, audit events, PII scrubbing, Witness receipts, and protection profiles | MCP over HTTP, bundled stdio bridge, REST API, Docker Compose, Codespaces, auth profiles, and optional per-session isolation |
  44. ## Quickstart
  45. ```bash
  46. git clone https://github.com/LvcidPsyche/auto-browser.git
  47. cd auto-browser
  48. docker compose up --build
  49. ```
  50. That is enough for local development with the default settings. On first start the controller
  51. generates an API token and saves it to `data/api-token` in this folder (git ignores it), and
  52. every API and MCP request must send it as `Authorization: Bearer <token>`, apart from the health
  53. checks, `/version`, the dashboard page, share links and `/mesh/receive`. The dashboard asks
  54. for it once, the examples below read it with `$(cat data/api-token)`, and the MCP clients take
  55. it as shown under [MCP Clients](#mcp-clients). `API_ALLOW_TOKENLESS_LOOPBACK=true` runs the
  56. controller without a token, as it ran before, but then any container on the compose network
  57. can drive the browser (a write a browser sends from another web origin is refused).
  58. Optional:
  59. ```bash
  60. cp .env.example .env
  61. make doctor
  62. ```
  63. Run `make doctor` from a normal terminal with local Docker access and permission to open localhost sockets.
  64. Open:
  65. - API docs: `http://127.0.0.1:8000/docs` (Authorize with the token to try requests). The docs need no token on a loopback deployment (an exposed one answers 401), and Swagger UI loads its assets from cdn.jsdelivr.net.
  66. - Operator dashboard: `http://127.0.0.1:8000/dashboard`, which includes the queue of actions waiting on your approval;
  67. paste the token when it asks, or open `http://127.0.0.1:8000/dashboard#token=<token>`
  68. - Visual takeover: `http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale`
  69. All published ports bind to `127.0.0.1` by default.
  70. ### Prebuilt images
  71. Every release is also published to GHCR, so you can skip the build:
  72. ```bash
  73. docker compose -f docker-compose.yml -f docker-compose.images.yml up -d
  74. ```
  75. `AUTO_BROWSER_IMAGE_TAG` picks the version: `latest` (the default), a release such as `1.10.1`, or
  76. `edge` for the current `main`. The images are linux/amd64, and each carries an SBOM and a build
  77. provenance attestation (`gh attestation verify oci://ghcr.io/lvcidpsyche/auto-browser-controller:latest -R LvcidPsyche/auto-browser`).
  78. The controller image leaves out the agent CLIs; for `*_AUTH_MODE=cli`, build from source with
  79. `INSTALL_AGENT_CLIS=true`.
  80. With isolated sessions, name `docker-compose.images.yml` last, so they start from the published browser image too:
  81. ```bash
  82. docker compose -f docker-compose.yml -f docker-compose.isolation.yml -f docker-compose.images.yml up -d
  83. ```
  84. In the other order, the isolation overlay's default wins, and isolated sessions run a local
  85. `auto-browser-browser-node:latest`: a stale build, or no image at all.
  86. ## Try It in Codespaces
  87. [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/LvcidPsyche/auto-browser?quickstart=1)
  88. Codespaces provisions the stack automatically. The dashboard and noVNC tabs are ready once both images have built and started; the first start builds them from source.
  89. ## First Useful Demo
  90. The highest-signal flow in this repo is:
  91. 1. create a session
  92. 2. log in manually if the site needs a human
  93. 3. save the session as a named auth profile
  94. 4. open a new session from that auth profile
  95. 5. continue work without reauthing
  96. Start here:
  97. - [`examples/login-and-save-profile.md`](./examples/login-and-save-profile.md)
  98. - [`examples/README.md`](./examples/README.md)
  99. Minimal session creation, from the auto-browser folder (`AUTH` carries the token; if you
  100. set `API_BEARER_TOKEN`, use `$API_BEARER_TOKEN` in place of `$(cat data/api-token)`):
  101. ```bash
  102. AUTH=(-H "Authorization: Bearer $(cat data/api-token)")
  103. curl -s "${AUTH[@]}" http://127.0.0.1:8000/sessions \
  104. -X POST \
  105. -H 'content-type: application/json' \
  106. -d '{"name":"demo","start_url":"https://example.com"}' | jq
  107. ```
  108. Minimal observation:
  109. ```bash
  110. curl -s "${AUTH[@]}" http://127.0.0.1:8000/sessions/<session-id>/observe | jq
  111. ```
  112. ## Recent Changes
  113. See [CHANGELOG.md](./CHANGELOG.md) for the full release history.
  114. ## MCP Clients
  115. Auto Browser exposes:
  116. - an HTTP MCP endpoint at `http://127.0.0.1:8000/mcp`
  117. - convenience endpoints at `http://127.0.0.1:8000/mcp/tools` and `http://127.0.0.1:8000/mcp/tools/call`
  118. - a stdio bridge: `uvx auto-browser-mcp` from PyPI, or [`scripts/mcp_stdio_bridge.py`](./scripts/mcp_stdio_bridge.py) in a repo checkout
  119. Clients that speak MCP over HTTP connect directly, sending the controller's token. With Claude
  120. Code or Codex, from the auto-browser folder (`--scope user` makes the server available in every
  121. project, not only this folder):
  122. ```bash
  123. claude mcp add --transport http --scope user auto-browser http://127.0.0.1:8000/mcp \
  124. --header "Authorization: Bearer $(cat data/api-token)"
  125. # Codex reads the token from the variable you name: export it wherever Codex runs.
  126. export AUTO_BROWSER_TOKEN="$(cat data/api-token)"
  127. codex mcp add auto-browser --url http://127.0.0.1:8000/mcp --bearer-token-env-var AUTO_BROWSER_TOKEN
  128. ```
  129. Google Antigravity takes the server in its raw MCP config (MCP Servers, then Manage MCP
  130. Servers, then View raw config), or in `~/.gemini/config/mcp_config.json`. It reads
  131. `serverUrl`, not `url`, and the token goes in `headers`:
  132. ```json
  133. {
  134. "mcpServers": {
  135. "auto-browser": {
  136. "serverUrl": "http://127.0.0.1:8000/mcp",
  137. "headers": { "Authorization": "Bearer <contents of data/api-token>" }
  138. }
  139. }
  140. }
  141. ```
  142. Cursor, VS Code, Claude Desktop through the stdio bridge (which reads the file named by
  143. `AUTO_BROWSER_TOKEN_FILE` / `--token-file`; the repo wrapper, `make stdio-bridge` or
  144. `scripts/mcp_stdio_bridge.py`, defaults that to its checkout's `data/api-token` for a loopback
  145. URL), and pairing Auto Browser with a web-search MCP server are covered in
  146. [`docs/mcp-clients.md`](./docs/mcp-clients.md).
  147. The default MCP tool profile is `curated`: the 20 tools (21 with a vision model) a browsing agent needs (sessions, observe and screenshot, `execute_action`, page and download reading, tabs, auth profiles, `wait_for_selector`, `eval_js`, human takeover). Every listed tool costs the model context on every request, so the diagnostics, audit, harness, and admin tools are in the full profile. To expose everything, set:
  148. ```bash
  149. MCP_TOOL_PROFILE=full
  150. ```
  151. `MCP_TOOL_PROFILE=lean` serves just the 7-tool browsing loop (observe, screenshot, `execute_action`, `get_html`, `find_elements`, human takeover, close), and `MCP_TOOL_PACKS` adds or removes named packs on top of any profile, e.g. `MCP_TOOL_PACKS=tabs,downloads` or `-scripting`. The pack table is in [`docs/mcp-clients.md`](./docs/mcp-clients.md#mcp-tool-profiles-and-packs).
  152. Raw tool-call example:
  153. ```bash
  154. curl -s "${AUTH[@]}" http://127.0.0.1:8000/mcp/tools/call \
  155. -X POST \
  156. -H 'content-type: application/json' \
  157. -d '{
  158. "name":"browser.create_session",
  159. "arguments":{
  160. "name":"demo",
  161. "start_url":"https://example.com"
  162. }
  163. }' | jq
  164. ```
  165. Client setup guides:
  166. - [`docs/mcp-clients.md`](./docs/mcp-clients.md)
  167. - [`examples/claude-desktop-setup.md`](./examples/claude-desktop-setup.md)
  168. - [`examples/cursor-mcp-setup.md`](./examples/cursor-mcp-setup.md)
  169. - [`examples/claude_desktop_config.json`](./examples/claude_desktop_config.json)
  170. For resource listing, resource reads, and subscription-style update examples,
  171. see [`docs/mcp-clients.md#resources-and-subscriptions`](./docs/mcp-clients.md#resources-and-subscriptions).
  172. ## Convergence Harness
  173. Auto Browser ships a Stage 0 convergence harness for Agent Skill Induction. It runs a structured task contract, records tamper-checked traces, verifies completion, and writes a staged skill candidate carrying provenance. With a mesh identity configured that provenance is signed, and the registry verifies the signature before serving a candidate — a candidate that fails the check, or that was dropped into the staging directory unsigned, is refused. Candidates induced from a mock run are marked `simulated` so they cannot pass as converged. Generated skills are staged only — promotion stays explicit and reviewed.
  174. The harness tools — convergence runs, run status and traces, drift checks, candidate management, and graduation — are in the `full` MCP tool profile (`MCP_TOOL_PROFILE=full`); over REST, `POST /mcp/tools/call` calls them once the controller serves them.
  175. Start with [`docs/convergence-harness.md`](./docs/convergence-harness.md). A deterministic local smoke is:
  176. ```bash
  177. python -m controller.harness.run --contract evals/contracts/example_read.json --mock-final-url https://example.com --mock-final-text "Example Domain"
  178. ```
  179. For MCP clients, set `MCP_TOOL_PROFILE=full` (or `MCP_TOOL_PACKS=harness` on top of curated) to expose the `harness.*` tools.
  180. ## Security and Compliance
  181. For a real private deployment, set at least:
  182. ```bash
  183. APP_ENV=production
  184. API_BIND_SCOPE=exposed
  185. API_BEARER_TOKEN=<strong-random-secret>
  186. REQUIRE_OPERATOR_ID=true
  187. AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
  188. REQUIRE_AUTH_STATE_ENCRYPTION=true
  189. SHARE_TOKEN_SECRET=<strong-random-secret>
  190. CONTROLLER_ALLOWED_HOSTS=<controller hostname>
  191. ALLOWED_HOSTS=<sites the browser may visit>
  192. REQUEST_RATE_LIMIT_ENABLED=true
  193. METRICS_ENABLED=true
  194. STEALTH_ENABLED=false
  195. ```
  196. With `APP_ENV=production` the controller refuses to start while the token, `REQUIRE_OPERATOR_ID`, either encryption setting, `SHARE_TOKEN_SECRET` or `CONTROLLER_ALLOWED_HOSTS` is missing, rate limiting is off, or `ALLOWED_HOSTS` is empty or `*`, and the startup log names each one; `ALLOWED_HOSTS` left out or at its example value, `METRICS_ENABLED=false` and `STEALTH_ENABLED=true` only warn.
  197. By default every session shares one Chromium process and one noVNC desktop (`SESSION_ISOLATION_MODE=shared_browser_node`). Cookies and storage stay separate per session, but a human taking over one session can see the others' windows. When sessions belong to different people, accounts or trust domains, start with `make up-isolation` to give each session its own browser container, takeover surface and Docker network (`docker_ephemeral`), so one session's browser cannot reach another's Playwright server. [`docs/session-isolation-audit.md`](./docs/session-isolation-audit.md) has the details.
  198. `ALLOWED_HOSTS` is held before the request goes out (`PRE_REQUEST_BLOCKING=true`, the default):
  199. - **Stopped before it is sent:** a top-level navigation's request to a host off `ALLOWED_HOSTS`, including
  200. every redirect hop and a popup's first request.
  201. - **Still caught after the fact by NAV-07** (the guard that sends a refused page back to `about:blank` once it
  202. commits):
  203. - speculation-rules prefetch in attach modes, and in a launched browser where it could not be turned off
  204. (launched browsers turn it off when the controller acquires them; `/readiness` warns when that failed);
  205. - a navigation a service worker serves (one a same-site refused iframe registered) for a popup's first
  206. navigation, and for any the popup makes before its service-worker bypass is set (a background task once
  207. the controller sees the popup), in every mode;
  208. - `blob:` navigations a refused iframe makes;
  209. - bfcache restores in attach modes;
  210. - requests held when the gate detaches, and any navigation a page starts itself before the replacement gate
  211. attaches. They go out. The controller attaches the replacement before it closes that browser's sessions,
  212. so the window is one attach, and it refuses their actions meanwhile.
  213. - **Any tab, rarely:** a navigation to a refused host fails closed in any tab of a gated browser, the
  214. operator's own included in attach modes, when the gate cannot classify its frame (its lookup failed).
  215. - **Not covered:** iframes and subresources of other hosts.
  216. In an attach mode (`CDP_CONNECT_URL`, `browser.cdp_attach`) the gate stops navigations of the controller's
  217. sessions only (apart from a frame it cannot classify, above), but every navigation in that Chrome, the
  218. operator's own tabs included, waits on its reply: about 13 ms each, the median measured on Chromium 151. Start
  219. that Chrome with `--disable-features=BlockOriginHeaderModificationOnRedirect,AvoidCorsURLLoaderRestartOnRedirect`
  220. and set `CDP_BLOCK_ORIGIN_ON_REDIRECT_DISABLED=true`. Without it, cross-origin 307/308 POST redirects can fail, and
  221. on Chrome 155 and later credentialed cross-origin requests that need a CORS preflight fail after a redirect, in
  222. the operator's own tabs too, while the controller is attached. Details:
  223. [`docs/deployment.md`](./docs/deployment.md#stopped-before-the-request-is-sent).
  224. `COMPLIANCE_TEMPLATE` can apply a preconfigured posture at startup:
  225. | Preset | Auth Encryption | Operator ID | PII Scrub | Isolation | Max Auth-State Age |
  226. | --- | --- | --- | --- | --- | --- |
  227. | `strict` | required | required | all layers | `docker_ephemeral` | 4h |
  228. | `balanced` | - | required | network + text | shared | 24h |
  229. Both presets require upload approvals and enable Witness receipts. Startup writes the applied policy to `/data/compliance-manifest.json`. The legacy names (`HIPAA`, `SOC2`, `GDPR`, `PCI-DSS`) still work as deprecated aliases and emit a warning at startup.
  230. Example:
  231. ```bash
  232. COMPLIANCE_TEMPLATE=strict docker compose up
  233. ```
  234. For deployment details, hosted Witness notes, CLI auth modes, and reverse-SSH guidance, see:
  235. - [`docs/deployment.md`](./docs/deployment.md)
  236. - [`docs/production-hardening.md`](./docs/production-hardening.md)
  237. - [`docs/session-isolation-audit.md`](./docs/session-isolation-audit.md): what each isolation mode does and does not separate
  238. ## Architecture at a Glance
  239. ```mermaid
  240. flowchart LR
  241. User[Human operator] -->|watch / takeover| noVNC[noVNC]
  242. LLM[Any model: OpenAI / Claude / Gemini / OpenRouter / Grok / DeepSeek / MiniMax / local] -->|shared tools| Controller[Controller API]
  243. Controller -->|Playwright protocol| Browser[Browser node]
  244. noVNC --> Browser
  245. Browser --> Artifacts[(screenshots / traces / auth state)]
  246. Controller --> Artifacts
  247. Controller --> Policy[Allowlist + approval gates]
  248. ```
  249. ### Model providers
  250. First-class adapters for **OpenAI**, **Claude**, and **Gemini** (API or CLI). Beyond those,
  251. a single generic **OpenAI-compatible** adapter drives any model reachable over an OpenAI
  252. `/chat/completions` endpoint — set an API key to enable it:
  253. | Provider | Reaches |
  254. |----------|---------|
  255. | `openrouter` | one key → ~every frontier model (Claude, GPT, Gemini, Grok, DeepSeek, Llama, Mistral, Qwen, …) |
  256. | `xai` | Grok |
  257. | `deepseek` | DeepSeek (text-only; driven from the DOM/accessibility outline) |
  258. | `minimax` | MiniMax |
  259. | `openai_compatible` | any custom base URL — self-hosted Ollama / vLLM / LM Studio, Azure OpenAI, Together, Groq, Fireworks, … |
  260. Vision (screenshots) is used for every provider except text-only ones. See `.env.example` for
  261. the `*_API_KEY` / `*_BASE_URL` / `*_MODEL` settings.
  262. Core components:
  263. - `browser-node/` runs Chromium, Xvfb, x11vnc, and noVNC
  264. - `controller/` exposes the FastAPI controller, MCP transport, policy rails, and orchestration endpoints
  265. - `data/` holds runtime artifacts, auth state, approvals, audit logs, and optional CLI caches
  266. - `scripts/` contains local helpers for doctor, smoke tests, bridges, and release checks
  267. ## Repo Guide
  268. | Path | What It Contains |
  269. | --- | --- |
  270. | [`controller/`](./controller/) | controller API, MCP transport, tests, and packaging |
  271. | [`browser-node/`](./browser-node/) | browser runtime and Playwright connection layer |
  272. | [`examples/`](./examples/) | copy-paste flows and MCP client setup |
  273. | [`integrations/langchain/`](./integrations/langchain/README.md) | LangChain, LangGraph, and CrewAI adapters |
  274. | [`docs/`](./docs/) | architecture, deployment, hardening, and launch docs |
  275. | [`scripts/`](./scripts/) | doctor, smoke harnesses, stdio bridge, and auth helpers |
  276. | [`ops/`](./ops/) | supporting service templates and operational assets |
  277. ## Common Commands
  278. | Command | Purpose |
  279. | --- | --- |
  280. | `make help` | list available repo commands |
  281. | `make lint` | run Ruff checks across the whole repo |
  282. | `make test` | run controller tests in Docker |
  283. | `make test-local` | run controller tests on host Python 3.11+ |
  284. | `make eval` | run deterministic provider/profile eval scoring |
  285. | `make doctor` | run the local readiness smoke |
  286. | `make release-audit` | run the fuller release-validation pass |
  287. | `make smoke-isolation` | verify per-session Docker isolation |
  288. | `make smoke-reverse-ssh` | verify reverse-SSH remote access |
  289. ## Documentation Map
  290. | If You Want To... | Start Here |
  291. | --- | --- |
  292. | understand the system shape | [`docs/architecture.md`](./docs/architecture.md) |
  293. | connect Claude, Codex, Antigravity, Cursor, or VS Code | [`docs/mcp-clients.md`](./docs/mcp-clients.md) |
  294. | run the curl-first examples | [`examples/README.md`](./examples/README.md) |
  295. | deploy on a trusted host | [`docs/deployment.md`](./docs/deployment.md) |
  296. | review production constraints | [`docs/production-hardening.md`](./docs/production-hardening.md) |
  297. | see what session isolation does and does not separate | [`docs/session-isolation-audit.md`](./docs/session-isolation-audit.md) |
  298. | run the convergence harness | [`docs/convergence-harness.md`](./docs/convergence-harness.md) |
  299. | run the agent evals | [`docs/agent-evals.md`](./docs/agent-evals.md) |
  300. | drive the built-in agent loop and its model providers | [`docs/llm-adapters.md`](./docs/llm-adapters.md) |
  301. | let a peer node ask this controller to run a tool (mesh) | [`docs/mesh.md`](./docs/mesh.md) |
  302. | inspect release history | [`CHANGELOG.md`](./CHANGELOG.md) |
  303. | see where the project is headed | [`ROADMAP.md`](./ROADMAP.md) |
  304. ## Contributing
  305. If you want to help, start with:
  306. - [`CONTRIBUTING.md`](./CONTRIBUTING.md)
  307. - [`docs/good-first-issues.md`](./docs/good-first-issues.md)
  308. - [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md)
  309. If Auto Browser is useful, a star helps other people find it. Sponsorship and tip options live in [`TIPS.md`](./TIPS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.