Grades are a hygiene check, not a security guarantee.

MCP, MCP server

witness

Quietly captures your Claude Code sessions and distills how your thinking, habits, and knowledge change over time — a dated growth archive with provenance, served over MCP.

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 6fe528d62e2b, unchanged since the check below.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV PERMISSION_SHELL_DECLARED SECRETS_ENV_READ

Why this grade

  • NETWORK_NO_FIXED_HOST Low

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

    scripts/fetch-model.sh, line 3 # Run once after clone (or let install.sh call it). No Python - curl against the HF CDN.

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    .gitignore, line 19 .env

  • PERMISSION_SHELL_DECLARED Note

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

    cmd/commands/cli.go, line 154 cmd := exec.Command(exe, args...)

  • SECRETS_ENV_READ Note

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

    npm/opencode/bin/model.js, line 86 const tokenizer = String(process.env.WITNESS_TOKENIZER_SHA256 || "").trim().toLowerCase()

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

    cmd/commands/cli.go, line 154

    cmd := exec.Command(exe, args...)

    cmd/commands/install.go, line 696

    // This is not hypothetical caution. The call used to be a bare exec.Command(...).Run() with

    cmd/commands/install.go, line 725

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

    Show more

    cmd/commands/nosubprocess_test.go, line 42

    // invoked `claude mcp remove witness` via a bare exec.Command(...).Run() - no deadline, no

    cmd/commands/nosubprocess_test.go, line 79

    // exec.CommandContext(ctx, "sleep", "60") and asserted that returned - which tests the Go

    cmd/commands/nosubprocess_test.go, line 80

    // standard library, not witness: reverting claudeCLICommand to a bare exec.Command (the exact

    cmd/commands/nosubprocess_test.go, line 122

    // site bypasses it with a bare exec.Command("claude", ...).

    cmd/commands/nosubprocess_test.go, line 140

    if strings.Contains(line, `exec.Command("claude"`) {

  • 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.

    NETWORK_NO_FIXED_HOST

    scripts/fetch-model.sh, line 3

    # Run once after clone (or let install.sh call it). No Python - curl against the HF CDN.

    scripts/fetch-model.sh, line 30

    fetch() {

    scripts/fetch-model.sh, line 41

    curl -fL --retry 3 "${BASE}/${path}" -o "$tmp"

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    npm/opencode/witness.test.js, line 178

    importEnvs.push(options?.env)

    npm/opencode/bin/model.js, line 86

    const tokenizer = String(process.env.WITNESS_TOKENIZER_SHA256 || "").trim().toLowerCase()

    .gitignore, line 19

    .env

    Show more

    npm/opencode/bin/model.test.js, line 61

    process.env.WITNESS_TOKENIZER_SHA256 = sha256("tokenizer-bytes")

    npm/opencode/bin/model.test.js, line 63

    process.env.WITNESS_TOKENIZER_MIN_BYTES = "1"

    npm/opencode/bin/model.test.js, line 71

    assert.equal(marker.tokenizer.sha256, process.env.WITNESS_TOKENIZER_SHA256)

    npm/opencode/bin/model.test.js, line 93

    process.env.WITNESS_TOKENIZER_SHA256 = sha256("tokenizer-bytes")

    npm/opencode/bin/model.test.js, line 95

    process.env.WITNESS_TOKENIZER_MIN_BYTES = "1"

    npm/opencode/bin/model.test.js, line 109

    process.env.WITNESS_TOKENIZER_MIN_BYTES = "1"

    npm/opencode/bin/model.test.js, line 119

    process.env.WITNESS_TOKENIZER_MIN_BYTES = "1"

    .gitignore, line 18

    # Secrets / env

    .gitignore, line 21

    !.env.example

  • 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.

Note

Hygiene check of commit 6fe528d62e2b. requests shell access. The manifest names this permission. 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: 6fe528d62e2bdfaa274bbf8385918f4e9f9fe52b

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