Grades are a hygiene check, not a security guarantee.

Claude Code, Plugin

The Librarian

Stop re-explaining your project every session.

Compatibility: Not stated.

Grade C

One Medium finding. Read the findings 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 2be089a1cfa7, unchanged since the check below.

PERMISSION_SHELL_UNDECLARED

Why this grade

  • PERMISSION_SHELL_UNDECLARED Medium

    Runs shell commands that the manifest or description does not mention.

    build.py, line 70 result = subprocess.run(cmd, check=True, **kwargs)

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

    Concern

    requests shell access. No manifest field names shell or command execution. can delete files.

    PERMISSION_SHELL_UNDECLARED PERMISSION_DELETE_FILES

    build.py, line 70

    result = subprocess.run(cmd, check=True, **kwargs)

    build.py, line 98

    shutil.rmtree(path)

    build.py, line 187

    shutil.rmtree(dst)

    Show more

    build.py, line 282

    result = subprocess.run(

    build.py, line 297

    result = subprocess.run(

    build.py, line 348

    shutil.rmtree(d)

    librarian_cli.py, line 215

    os.remove(p)

    librarian_cli.py, line 252

    os.remove(db_path)

  • Install and update

    Concern

    dependencies are not pinned.

    INSTALL_UNPINNED

    requirements.txt, line 6

    anthropic>=0.40.0

  • Network

    Concern

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

    NETWORK_NO_FIXED_HOST

    librarian_cli.py, line 814

    with urllib.request.urlopen(req, timeout=3) as resp:

    librarian_cli.py, line 3909

    with urllib.request.urlopen(req, timeout=10) as resp:

    librarian_cli.py, line 3976

    with urllib.request.urlopen(req, timeout=15) as resp:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    librarian_cli.py, line 185

    """Load config from .env file."""

    librarian_cli.py, line 187

    env_file = os.path.join(SCRIPT_DIR, ".env")

    librarian_cli.py, line 199

    api_key = os.environ.get("ANTHROPIC_API_KEY", "")

    Show more

    librarian_cli.py, line 1576

    'venv', 'env', '.env', '.tox', '.mypy_cache', '.pytest_cache',

    librarian_cli.py, line 3763

    Preserves user data (rolodex.db, vocab_packs/, CLAUDE.md, .env).

    main.py, line 44

    # Load config (resolve .env relative to this script, not CWD)

    main.py, line 45

    env_file = os.path.join(os.path.dirname(__file__), ".env")

    src/utils/config.py, line 3

    Loads settings from environment variables / .env file.

    src/utils/config.py, line 73

    def from_env(cls, env_path: str = ".env") -> "LibrarianConfig":

    src/utils/config.py, line 80

    anthropic_api_key=os.getenv("ANTHROPIC_API_KEY", ""),

    src/utils/config.py, line 85

    voyage_api_key=os.getenv("VOYAGE_API_KEY", ""),

    src/utils/config.py, line 109

    context_bridge_max_tokens=int(os.getenv("CONTEXT_BRIDGE_MAX_TOKENS", str(cls.context_bridge_max_tokens))),

  • 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 2be089a1cfa7. requests shell access. No manifest field names shell or command execution. can delete files. dependencies are not pinned. 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: 2be089a1cfa70d7c59b39394f47562d63b1b54ff

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