Agentinel logo

Agentinel

Reclamar

Agentinel is a local security layer for autonomous coding that intercepts AI-driven package installation requests, scans them against a bundled OSV database and heuristics, and blocks or warns on suspicious dependencies before execution.

Agentinel preview

Local dependency security for AI-driven coding

Agentinel is a local security layer for autonomous coding that checks package installation requests before they reach the terminal. It combines a bundled OSV database with heuristic signals such as package age, download counts, maintainer drift, and non-existent package names to identify suspicious dependencies.

The product is built for npm workflows and AI agent runtimes. It can intercept commands through a PreToolUse hook, block or warn on risky installs, and return structured feedback to the agent so it can correct itself without manual intervention.

Core capabilities

AI agent command interception

Registers as a PreToolUse hook so commands proposed by an AI agent are inspected before execution, rather than after something has already been installed.

Local OSV database scanning

Uses a bundled snapshot of the OSV npm subset stored locally in the package, avoiding cloud lookups and allowing scans to run without network dependence.

Heuristic slopsquatting detection

Applies signals such as package age, download count, publisher drift, and ghost-package detection to catch suspicious names that may not yet appear in the vulnerability database.

Strict or warn modes

Supports a strict mode that stops flagged installs and a warn mode that alerts instead of blocking, giving teams some control over enforcement.

Self-correction feedback loop

Serializes the block decision into JSON and feeds it back to the agent context so the agent can understand why a command was stopped and retry with a corrected action.

Repository and CI safeguards

Adds Git pre-commit scanning and can check staged lockfiles or full dependency trees, which makes it usable both in local development and in CI/CD pipelines.

Where it fits

  • Protecting AI-assisted installs

    Useful when an AI agent suggests a package name that looks plausible but is incorrect or malicious, because Agentinel inspects the request before the shell command runs.

  • Reviewing new or low-trust dependencies

    Helps developers assess packages that are very new, have low download counts, or show maintainer drift, which are the kinds of signals the heuristic layer looks for.

  • Scanning lockfiles in CI

    Can be used in pipelines to check staged or full lockfile dependencies before merges or deployments, giving teams a pre-execution gate for suspicious packages.

  • Enforcing team allowlists

    Supports adding internal packages to an allowlist with a required reason, making it easier to document approved exceptions in version control.

  • Running quick package checks

    The single-package check command is useful when a developer wants to inspect one package name before installing it manually or scripting validation around it.

Pros and Cons

Pros

  • Runs locally with no cloud calls, which keeps package scans private and usable in disconnected environments.
  • Interposes before execution at the agent hook level, so it can stop risky installs earlier than terminal-only scanners.
  • Combines OSV matching with heuristic checks, which helps it catch both known malicious packages and suspicious new ones.
  • Provides structured feedback back to the AI agent, supporting autonomous correction rather than only human review.
  • Includes practical workflow support such as pre-commit hooks, CI checks, allowlisting, and mode controls.

Cons

  • The bundled OSV snapshot can lag the live feed by about 1-3 days, so very recent threats may not be in the database yet.
  • The documentation says it focuses on npm and does not provide behavioral runtime analysis of package code.
  • Heuristic flags are static signals rather than ML-based behavioral detection, so a novel threat that passes both OSV and heuristics may not be caught.

FAQ

Does Agentinel require cloud access?

No. The product materials say it runs locally, uses a bundled OSV database, and makes no cloud calls during scanning.

What does Agentinel actually scan?

It scans package names and versions against the local OSV snapshot and heuristic signals, and it can also check staged or full lockfile dependencies.

Can it stop an AI agent before a package is installed?

Yes. Agentinel is designed to register as a PreToolUse hook so it can intercept the agent’s command before execution.

What happens when a package is blocked?

In strict mode it stops the install, while in warn mode it alerts instead. The block context is also returned to the agent as structured JSON so the agent can self-correct.

Is it only for npm?

The source materials describe npm as the supported ecosystem in the current version, and the install and commands shown are npm-based.

Quick Facts

Category
Developer Tool
Primary ecosystem
npm / Node.js
Deployment model
Local, no cloud calls
Core workflow
AI agent hook, package scanning, and lockfile checks
Install command
npm install --save-dev agentinel
Docs command alias
asen