Grades are a hygiene check, not a security guarantee.

MCP, MCP server

io.github.PramodDutta/browserbash

Plain-English browser automation.

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit b95a07af09db, unchanged since the check below.

NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV PERMISSION_SHELL_DECLARED SECRETS_ENV_READ OBFUSCATION_FILE_CAP_REACHED

Why this grade

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    site/components/ConnectCard.tsx, line 23 const res = await fetch('/api/keys');

  • NETWORK_UNNAMED_HOST Low

    Calls a fixed host that the description does not name.

    site/components/ConnectCard.tsx, line 23 const res = await fetch('/api/keys');

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    .gitignore, line 9 .env

  • PERMISSION_SHELL_DECLARED Note

    Runs shell commands, and the manifest or description says so.

    site/content/blog/browser-automation-for-crewai.md, line 92 proc = subprocess.run(

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    site/proxy.ts, line 28 const hasClerk = !!process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY;

  • OBFUSCATION_FILE_CAP_REACHED Note

    The 400 file cap was reached before every file was read.

    site/content/blog/browserbash-vs-multion.md, line 1 ---

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Note

    requests shell access. The manifest names this permission.

    PERMISSION_SHELL_DECLARED

    site/content/blog/browser-automation-for-crewai.md, line 92

    proc = subprocess.run(

    site/content/blog/browserbash-vs-playwright-mcp.md, line 36

    With BrowserBash, the loop lives inside the CLI. You (or your CI job, or your coding agent) issue one command. Internally, the chosen engine runs its own plan-act-observe cycle aga

    site/content/blog/playwright-mcp-vs-browser-use.md, line 124

    That exit-code contract is precisely the thing you would have to build by hand on top of either Playwright MCP or browser-use. Here it is the default behavior of a tool you install

    Show more

    site/content/blog/selenium-python-vs-plain-english-browser-tests.md, line 82

    result = subprocess.run(

    site/content/blog/selenium-python-vs-plain-english-browser-tests.md, line 148

    No. BrowserBash is a Node.js CLI, installed with `npm install -g browserbash-cli`. There's no `pip install` and no Python import; you invoke it as a subprocess or a separate CI ste

    site/content/blog/stagehand-node-library-vs-language-agnostic-cli.md, line 47

    result = subprocess.run(

    site/content/blog/stagehand-node-library-vs-language-agnostic-cli.md, line 108

    | Python / pytest shop | New `package.json`, `tsconfig.json`, a pinned Node runtime, `.ts` files with `import`, a second CI stage | One global install; `subprocess.run(["browserbas

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address. can reach notify.bugsnag.com. The description does not name that host.

    NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST

    site/components/ConnectCard.tsx, line 23

    const res = await fetch('/api/keys');

    site/components/ConnectCard.tsx, line 31

    const res = await fetch('/api/keys', { method: 'POST' });

    site/components/ConnectCard.tsx, line 45

    await fetch('/api/keys', { method: 'DELETE' });

    Show more

    site/components/EmailCapture.tsx, line 24

    const res = await fetch('/api/subscribe', {

    site/components/Onboarding.tsx, line 22

    const res = await fetch('/api/onboarding', {

    site/components/RunsTable.tsx, line 27

    fetch('/api/runs')

    site/components/TryIt.tsx, line 16

    fetch(active.file)

    docs/reports/2026-06-12-seo-audit.md, line 3

    **Date:** 2026-06-12 · All findings verified by direct fetch (/, /learn, robots.txt, sitemap.xml, llms.txt, og.png + crawler-UA tests).

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    site/proxy.ts, line 28

    const hasClerk = !!process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY;

    site/app/layout.tsx, line 165

    return process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY ? (

    .gitignore, line 9

    .env

    Show more

    site/app/page.tsx, line 50

    {process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY ? (

    site/app/api/cron/cleanup/route.ts, line 18

    const secret = process.env.CRON_SECRET;

    site/app/dashboard/page.tsx, line 24

    if (!process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY) notFound();

    site/app/dashboard/runs/[id]/page.tsx, line 30

    if (!process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY) notFound();

    site/app/sign-in/[[...sign-in]]/page.tsx, line 20

    if (process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY) {

    site/app/sign-in/[[...sign-in]]/page.tsx, line 32

    {process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY ? (

    .gitignore, line 8

    # Env files (secrets - never commit)

    .gitignore, line 11

    !.env.local.example

    docs/superpowers/plans/2026-06-11-browserbash-launch.md, line 410

    - [ ] Step 3: Add `site/.env.local.example` documenting `DATABASE_URL`, `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY`, `CLERK_SECRET_KEY`, `ADMIN_EMAILS`. Append `site/.env*.local` + `site/.

    examples/ttacart_login_test.md, line 9

    framework's `.env.example`. For real secrets use `{{variables}}` (masked in logs).

    site/.gitignore, line 33

    # env files (can opt-in for committing if needed)

    site/content/blog/ai-browser-automation-credentials-secrets-safety.md, line 107

    Two things follow. One, those provider credentials are themselves secrets - put them in CI's encrypted secret storage, never in a `.env` committed to the repo, and rotate them like

    site/content/blog/ai-testing-for-fintech-apps.md, line 80

    Mark the variable as secret in the test, but source its value from your existing secrets manager - a CI secret, a `.env` that is gitignored, a vault. BrowserBash does not want to o

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    the file cap was reached before every file was read.

    OBFUSCATION_FILE_CAP_REACHED

    site/content/blog/browserbash-vs-multion.md, line 1

    ---

  • Licence

    Note

    no licence file found.

    LICENCE_MISSING

    No file path was stored.

    no licence file found.

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit b95a07af09db. requests shell access. The manifest names this permission. can reach a host that is not written as a fixed address. can reach notify.bugsnag.com. The description does not name that host. reads a credential or environment file. the file cap was reached before every file was read. no licence file found.

Date and source

Date checked:

View source

github.com

Commit graded: b95a07af09db9b5a7885fb710493d02141d7ea97

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen