S

Shell, Git, and filesystem protection

Reviews destructive shell, Git, filesystem, redirection, and protected configuration mutations.

command.shell-mutations · v1.0.0 · Core safety

By HOL Guard TeamBuilt-in coverageCommand coverage
Protection rules
5
Permission checks
5
Mapped commands
5

Overview

What this coverage does

Reviews destructive shell, Git, filesystem, redirection, and protected configuration mutations.

Key facts

Catalog ID
command.shell-mutations
Version
v1.0.0
Kind
Command coverage
Category
Core safety
Protection rules
5
Permission checks
5
Mapped commands
5
Maintainer
HOL Guard Team(project-maintained)
Source commit
00d0807
Protection model
Built-in coverage
Built-in coverage

This coverage is built into the native Guard runtime.

Stated limits

  • Coverage is limited to the reviewed operations and the surrounding Guard policy.
  • A maintainer profile is not a security certification or an official upstream endorsement.

Command mapping

Every command this extension recognizes, with the catalog default floor Guard applies before workspace policy. Search the table, then open an operation for safe variants and the permission ID.

5 operations · 5 reviewed by default These are catalog defaults, not your workspace policy.

5 operations5 reviewed
Default floor

Showing 5 of 5 operations

  • Reviewed Guard intercepts the command for review before it runs.High
    • find /var/tmp -name "*.log" -delete
    Destructive shell mutation
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies destructive shell, filesystem, and version-control mutations.
    Permission ID
    command.shell-mutations.permission.destructive-shell
  • Reviewed Guard intercepts the command for review before it runs.High
    • gh pr create --body "$(curl -s https://example.com)"
    Command substitution in remote body
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies shell substitution used to construct a remote request body.
    Permission ID
    command.shell-mutations.permission.github-body-substitution
  • Reviewed Guard intercepts the command for review before it runs.High
    • echo "session = on" >> ~/.hol-guard/config.toml
    Guard-managed configuration write
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies direct writes to configuration managed by Guard.
    Permission ID
    command.shell-mutations.permission.managed-config-write
  • Reviewed Guard intercepts the command for review before it runs.High
    • python3 -c 'import os; print(os.environ)'
    Process environment secret read
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies commands that print process environment secrets to the agent.
    Permission ID
    command.shell-mutations.permission.process-environment-secret-read
  • Reviewed Guard intercepts the command for review before it runs.High
    • echo "ssh-ed25519 KEY" >> ~/.ssh/authorized_keys
    Sensitive local file write
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies writes that can replace or expose sensitive local state.
    Permission ID
    command.shell-mutations.permission.sensitive-file-write

Tool state mapping

No per-tool overrides are declared. Command defaults above resolve through the workspace Guard policy unless a later policy layer changes them.

Runtime identity

Catalog ID
command.shell-mutations
Guard enforcement ID
command.shell-mutations
Source path
contributions/extensions/command.shell-mutations.json
Contribution digest
sha256…7d68db

Action classes

destructive shell commandguard-managed config writesensitive local file writeGitHub PR body shell substitutionprocess environment secret read

Technical profile

No independent profile published

This extension has no current independent technical profile. Catalog facts and any legacy launch remain separate and are not presented as profile evidence.

FAQ

Frequently asked questions

Reviews destructive shell, Git, filesystem, redirection, and protected configuration mutations. The listing declares 5 rules and 5 permission checks. 5 operations · 5 reviewed by default. Coverage is limited to these reviewed operations and the surrounding Guard policy.

Built-in coverage: This coverage is built into the native Guard runtime. Enabling state is always controlled through Guard policy, never from this directory.

This listing is maintained by the HOL Guard project itself as part of the native runtime catalog.

No. Every listing documents source, activation model, maintainer identity, and stated limitations so you can evaluate coverage before enabling it. Review the stated limitations and the exact source tree before relying on any single control.

5 operations · 5 reviewed by default. Examples: find /var/tmp -name "*.log" -delete (reviewed by default); gh pr create --body "$(curl -s https://example.com)" (reviewed by default); echo "session = on" >> ~/.hol-guard/config.toml (reviewed by default); python3 -c 'import os; print(os.environ)' (reviewed by default); echo "ssh-ed25519 KEY" >> ~/.ssh/authorized_keys (reviewed by default). These are catalog defaults, not your workspace policy.

This coverage is built into the native Guard runtime. Enablement is managed through your workspace's Guard policy and controls — never from this directory. Open the install guidance for the setup flow, then adjust the command coverage for command.shell-mutations in Guard's policy surface.

The matching action is stopped at Guard's pre-action boundary before it executes, and the decision is recorded with evidence your workspace can review. Exact behavior follows your Guard policy combined with this entry's 5 rules and 5 permission checks.

No. Guard is local-first: interception, decisions, and evidence stay on your machine unless your workspace explicitly configures cloud features. This page is documentation only — it never executes a command or changes protection state.

Guard runs locally alongside the major AI coding agents and MCP-capable harnesses, so this coverage applies wherever Guard intercepts actions. See the supported harness guides at https://hol.org/guard/harnesses for per-tool approval behavior and limitations.

Guard has a free local tier that includes command interception, evidence, and the policy controls this listing documents. Team plans add shared policy, review queues, and audit surfaces. Current plans: https://hol.org/guard/pricing

Open an issue or pull request against the hol-guard repository, where the canonical catalog lives: https://github.com/hashgraph-online/hol-guard Listings are corrected through the same public review process that adds them.

Yes — community coverage is accepted through public pull requests with recorded provenance. Project-maintained listings like this one are extended by the HOL Guard team; propose new operations through the hol-guard repository.

The command mapping table is the audit trail for covered commands and catalog default floors. Pair it with the reviewed rule and permission counts, the per-tool state mapping, and the exact source tree linked from View exact source at the reviewed commit. Guard records enforcement decisions with evidence locally, so what ships matches what you reviewed.