Grades are a hygiene check, not a security guarantee.

MCP, MCP server

io.github.btouchard/herald

Herald Code from your phone.

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.

NETWORK_NO_FIXED_HOST SECRETS_PATH_UNCONFIRMED PERMISSION_SHELL_DECLARED INSTALL_DOCUMENTED_INSTALLER SECRETS_ENV_READ

Why this grade

  • NETWORK_NO_FIXED_HOST Low

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

    install.sh, line 112 if command -v curl >/dev/null 2>&1; then

  • SECRETS_PATH_UNCONFIRMED Low

    The Secrets check reports a credential or environment file, but no quoted line shows a recognisable path.

    internal/config/loader.go, line 73 if token := os.Getenv("HERALD_NGROK_AUTHTOKEN"); token != "" {

  • PERMISSION_SHELL_DECLARED Note

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

    internal/executor/claude/claude.go, line 82 cmd := exec.CommandContext(ctx, e.ClaudePath, args...) //nolint:gosec // ClaudePath from trusted config

  • INSTALL_DOCUMENTED_INSTALLER Note

    Documentation shows an installer that pipes a download into a shell.

    README.md, line 162 curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

  • SECRETS_ENV_READ Note

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

    internal/config/loader.go, line 73 if token := os.Getenv("HERALD_NGROK_AUTHTOKEN"); token != "" {

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

    internal/executor/claude/claude.go, line 82

    cmd := exec.CommandContext(ctx, e.ClaudePath, args...) //nolint:gosec // ClaudePath from trusted config

    internal/git/git.go, line 132

    cmd := exec.CommandContext(ctx, "git", args...)

    internal/git/git_test.go, line 25

    cmd := exec.Command(args[0], args[1:]...) //nolint:gosec // test helper with hardcoded args

    Show more

    internal/git/git_test.go, line 102

    cmd := exec.Command("git", "add", "new.txt")

    internal/git/git_test.go, line 106

    cmd = exec.Command("git", "commit", "-m", "add file")

    internal/git/git_test.go, line 148

    cmd := exec.Command("git", "init")

    internal/git/git_test.go, line 164

    cmd := exec.Command("git", "add", "file.txt")

    internal/git/git_test.go, line 167

    cmd = exec.Command("git", "commit", "-m", "add file")

  • Install and update

    Note

    README documents an installer that pipes a download into a shell. The docs document an installer that pipes a download into a shell.

    INSTALL_DOCUMENTED_INSTALLER

    README.md, line 162

    curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

    README_FR.md, line 162

    curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

    docs/getting-started/installation.md, line 19

    curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

    Show more

    docs/getting-started/installation.md, line 27

    INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

  • Network

    Concern

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

    NETWORK_NO_FIXED_HOST

    install.sh, line 112

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

    install.sh, line 113

    curl -fsSL "$url" | parse_version

    install.sh, line 114

    elif command -v wget >/dev/null 2>&1; then

    Show more

    install.sh, line 115

    wget -qO- "$url" | parse_version

    install.sh, line 117

    printf "curl or wget required\n" >&2; exit 1

    install.sh, line 126

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

    install.sh, line 127

    curl -fsSL -o "$2" "$1"

    install.sh, line 129

    wget -qO "$2" "$1"

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_UNCONFIRMED

    internal/config/loader.go, line 73

    if token := os.Getenv("HERALD_NGROK_AUTHTOKEN"); token != "" {

    .gitignore, line 16

    # Environment

  • Agent instructions

    Pass

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

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Get the full report on this tool, £49

Note

Hygiene check of commit 5e9982e26f92. requests shell access. The manifest names this permission. README documents an installer that pipes a download into a shell. The docs document an installer that pipes a download into a shell. can reach a host that is not written as a fixed address. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: 5e9982e26f92dcd16602209f799634d065453a3f

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