Grades are a hygiene check, not a security guarantee.

MCP, MCP server

io.github.VineetV2/peon-mem

Local-first, hierarchical, self-improving memory for Claude Code, Codex, and any MCP client.

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 8858bb41a060, unchanged since the check below.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV 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.

    bin/peon-mem.mjs, line 204 try { const r = await fetch("http://127.0.0.1:3737/health"); return (await r.json()).ok === true; } catch { return false; }

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    vitest.config.ts, line 10 // Keep the suite hermetic: never touch the network even if a real .env with an

  • INSTALL_DOCUMENTED_INSTALLER Note

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

    README.md, line 116 (no Node? `curl -fsSL https://raw.githubusercontent.com/VineetV2/peon-mem/main/install.sh | bash`)

  • SECRETS_ENV_READ Note

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

    scripts/peon-stl.mjs, line 133 if (process.env.OPENROUTER_API_KEY) return process.env.OPENROUTER_API_KEY;

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

    Pass

    No shell or command execution found, and no extra permission was declared.

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

    (no Node? `curl -fsSL https://raw.githubusercontent.com/VineetV2/peon-mem/main/install.sh | bash`)

    install.sh, line 2

    # Peon one-line installer: curl -fsSL https://raw.githubusercontent.com/VineetV2/peon-mem/main/install.sh | bash

  • Network

    Concern

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

    NETWORK_NO_FIXED_HOST

    bin/peon-mem.mjs, line 204

    try { const r = await fetch("http://127.0.0.1:3737/health"); return (await r.json()).ok === true; } catch { return false; }

    bin/peon-mem.mjs, line 243

    const up = await fetch("http://127.0.0.1:11434/api/tags").then((r) => r.ok).catch(() => false);

    scripts/claude-peon-hook.mjs, line 258

    const response = await fetch(`${daemonUrl}${path}`, {

    Show more

    scripts/claude-peon-hook.mjs, line 273

    const response = await fetch(url);

    scripts/claude-peon-hook.mjs, line 306

    const response = await fetch(url);

    scripts/eval-retrieval-labeled.mjs, line 31

    const r = await fetch("https://openrouter.ai/api/v1/chat/completions", {

    scripts/eval-retrieval.mjs, line 32

    const r = await fetch("https://openrouter.ai/api/v1/chat/completions", {

    scripts/longmemeval-eval.mjs, line 34

    const r = await fetch("https://openrouter.ai/api/v1/chat/completions", {

    scripts/peon-stl.mjs, line 279

    try { return (await fetch(`${DAEMON}/health`, { signal: ctrl.signal, headers: { host: "127.0.0.1" } })).ok; }

    scripts/peon-stl.mjs, line 286

    const res = await fetch(`${DAEMON}/recurate`, {

    scripts/peon-stl.mjs, line 315

    const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {

    src/compression.ts, line 22

    const response = await withModelSlot(config, () => fetch(llmEndpoint(config), {

    src/daemon-cli.ts, line 13

    const response = await fetch(`http://${host}:${port}/health`, { signal: controller.signal });

    src/global-extraction.ts, line 40

    const response = await withModelSlot(config, () => fetch(llmEndpoint(config), {

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    vitest.config.ts, line 10

    // Keep the suite hermetic: never touch the network even if a real .env with an

    bin/peon-mem.mjs, line 225

    const envFile = join(memoryHome, ".env");

    scripts/peon-stl.mjs, line 133

    if (process.env.OPENROUTER_API_KEY) return process.env.OPENROUTER_API_KEY;

    Show more

    bin/peon-mem.mjs, line 322

    log("config : " + join(DEFAULT_HOME, ".env") + (existsSync(join(DEFAULT_HOME, ".env")) ? "" : " (missing - run peon-mem install)"));

    scripts/install-peon-stl.mjs, line 29

    const WORKING_DIR = join(HOME, "Documents", "Project_x 2"); // dir that holds Peon's .env

    scripts/peon-stl.mjs, line 131

    /** Resolve the OpenRouter key the same way the daemon does: env first, then a climbed .env. */

    scripts/peon-stl.mjs, line 137

    const f = join(cur, ".env");

    scripts/peon-stl.mjs, line 145

    } catch { /* unreadable .env → keep climbing */ }

    src/config.ts, line 138

    const candidate = join(current, ".env");

    src/overview.ts, line 89

    const MAX_TOKEN_BUCKET = Number(process.env.PEON_DUPLICATE_MAX_TOKEN_BUCKET) > 0

    src/overview.ts, line 90

    ? Number(process.env.PEON_DUPLICATE_MAX_TOKEN_BUCKET)

    src/processor.ts, line 490

    max_tokens: Number(process.env.PEON_CONSOLIDATION_MAX_TOKENS) || 8192

    src/processor.ts, line 799

    max_tokens: Number(process.env.PEON_CONSOLIDATION_MAX_TOKENS) || 8192,

  • 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 8858bb41a060. 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: 8858bb41a0601a92504bf21fd1b5eea4b13e72c8

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