Grades are a hygiene check, not a security guarantee.

Claude Code, Skill

bub

Bub it.

Compatibility: Not stated.

Grade D

Two or more Medium findings, or a High finding. Only try it in a sandbox.

Graded by PlugVetRubric v2

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

Rescanned at commit a93f5b80cf4b.

INSTALL_REMOTE_SCRIPT

Why this grade

  • INSTALL_REMOTE_SCRIPT High

    Fetches a script from the network and runs it (a pipe to a shell, or an install hook with a URL).

    website/public/install.sh, line 67 curl -fsSL https://bub.build/install.sh | bash

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.

If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.

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

    src/bub/gateway_installer.py, line 222

    subprocess.run(command, check=True, capture_output=True, text=True)

    src/bub/builtin/auth.py, line 39

    subprocess.run(command, env={**os.environ, "CODEX_HOME": str(home)}, check=True)

    src/bub/builtin/cli.py, line 232

    return subprocess.run([uv_executable, *args], env=env, check=True, cwd=cwd)

    Show more

    website/public/install.ps1, line 125

    Invoke-Expression $UvInstaller

    website/src/content/docs/docs/reference/cli.mdx, line 151

    Exit codes mirror `uv`; non-zero from the underlying `subprocess.run` is propagated.

    website/src/content/docs/zh-cn/docs/reference/cli.mdx, line 151

    退出码沿用 `uv`:底层 `subprocess.run` 的非零退出码会被透传。

  • Install and update

    Serious

    install fetches a script from the network. The docs document an installer that pipes a download into a shell.

    INSTALL_REMOTE_SCRIPT INSTALL_DOCUMENTED_INSTALLER

    website/public/install.sh, line 67

    curl -fsSL https://bub.build/install.sh | bash

    website/public/install.sh, line 68

    curl -fsSL https://bub.build/install.sh | bash -s -- --preset recommended

    website/public/install.sh, line 69

    curl -fsSL https://bub.build/install.sh | bash -s -- --preset minimal --dependency bub-mcp@main

    Show more

    website/src/data/landing-page.ts, line 109

    command: 'curl -fsSL https://bub.build/install.sh | bash',

    website/src/data/landing-page.ts, line 215

    command: 'curl -fsSL https://bub.build/install.sh | bash',

    README.md, line 39

    curl -fsSL https://bub.build/install.sh | bash

    website/src/content/docs/docs/getting-started/install.mdx, line 37

    curl -fsSL https://bub.build/install.sh | bash

    website/src/content/docs/zh-cn/docs/getting-started/install.mdx, line 37

    curl -fsSL https://bub.build/install.sh | bash

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    src/skills/telegram/scripts/telegram_edit.py, line 71

    response = requests.post(url, json=payload, timeout=30)

    src/skills/telegram/scripts/telegram_rich.py, line 71

    response = requests.post(url, json=payload, timeout=30)

    src/skills/telegram/scripts/telegram_rich.py, line 75

    response = requests.post(url, json=payload, timeout=30)

    Show more

    src/skills/telegram/scripts/telegram_rich.py, line 107

    response = requests.post(url, json=payload, timeout=30)

    src/skills/telegram/scripts/telegram_send.py, line 69

    response = requests.post(url, json=payload, timeout=30)

    src/skills/telegram/scripts/telegram_send.py, line 112

    response = requests.post(url, json=payload, timeout=30)

    src/skills/telegram/scripts/telegram_send.py, line 115

    response = requests.post(url, json=payload, timeout=30)

    website/public/install.sh, line 132

    if command -v curl >/dev/null 2>&1; then

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    src/skills/telegram/scripts/telegram_edit.py, line 87

    bot_token = args.token or os.environ.get("BUB_TELEGRAM_TOKEN")

    src/skills/telegram/scripts/telegram_rich.py, line 173

    bot_token = args.token or os.environ.get("BUB_TELEGRAM_TOKEN")

    src/skills/telegram/scripts/telegram_send.py, line 161

    bot_token = args.token or os.environ.get("BUB_TELEGRAM_TOKEN")

    Show more

    website/scripts/generate-github-snapshot.mjs, line 28

    ...(process.env.GITHUB_TOKEN ? { Authorization: `Bearer ${process.env.GITHUB_TOKEN}` } : {}),

    src/bub/__init__.py, line 54

    # Importing bub.configure loads ``.env``, which may set ``BUB_HOME``.

    src/bub/configure.py, line 10

    # Settings read the environment, so load ``.env`` before any of them is created.

    src/bub/builtin/spill.py, line 31

    model_config = SettingsConfigDict(env_prefix="BUB_SPILL_", extra="ignore", env_file=".env")

    src/bub/channels/manager.py, line 28

    model_config = SettingsConfigDict(env_prefix="BUB_", extra="ignore", env_file=".env")

    src/bub/channels/telegram.py, line 28

    model_config = SettingsConfigDict(env_prefix="BUB_TELEGRAM_", extra="ignore", env_file=".env")

    AGENTS.md, line 63

    - Use `.env` for local secrets; never commit credentials.

    docker-compose.yml, line 9

    - .env

  • Agent instructions

    Pass

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

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    uv.lock, line 1

    version = 1

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit a93f5b80cf4b. requests shell access. The manifest names this permission. install fetches a script from the network. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: a93f5b80cf4b1bb35a248f4108b463f7af44f08d

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