REPOSITORY ANALYSIS

Agent

An optional Jev command-risk advisor inside a native macOS Agent, with a TypeSafeKit client.

E2 · source reviewedPublic material or source evidence was reviewed. A fixed-version source review requires checking a pinned revision; this is not a reproduction, performance endorsement, or safety guarantee.
Stars
632
Forks
69
License
—
Last commit
2026-09-23

What Jev does here

Adds a destructive-risk judgment after local shell checks and refuses commands above the configured threshold.

API failures generally allow the command with a warning, so it is not complete system protection.

Jev is an optional additional risk judgment and failures generally fail open; no system-security validation was performed.

What task does this project fit?

Add an optional destructive-command advisory check to a native macOS agent.

Material analysed:

From input to action

  1. Run existing local shell-safety checks.
  2. Ask Jev for a destructive-risk assessment when configured.
  3. Refuse above the chosen threshold, or log that no model opinion was available.

Implementation details that matter

Provider failure is explicitly fail-open

JevAdvisor.shellBlockReason catches errors, reports that the command is allowed and returns nil. Turning on the option is not a guarantee that commands stop when the service is unavailable.

Inspect the supporting source ↗

The judgment follows deterministic safety checks

The README places the advisor after ShellSafetyService across shell paths. A below-threshold model answer does not mean the command bypasses that earlier layer.

Inspect the supporting source ↗

When to choose it

Useful as another signal for a macOS automation harness. For operations that must stop on missing review, enforce that rule outside this optional advisor.

How to inspect it yourself

Read shellBlockReason's catch and return paths. With a fake provider, compare above-threshold, below-threshold, missing-key and cancellation behavior before enabling any destructive command.

Limits of this review

  • No macOS agent, privileged helper or model call was executed.
  • This is not evidence of endpoint security or resistance to malicious commands.
Primary material used in this analysis