S

seatbelt-guard command protection

Reviews seatbelt commands that remove or weaken the guardrail it installs for coding agents: removing its hook, installing it so a crashing

Reviews seatbelt commands that remove or weaken the guardrail it installs for coding agents: removing its hook, installing it so a crashing hook fails open, and editing agent settings.

command.seatbelt-guard · v1.0.0 · Other extensions

By Community contributorExternal · opt-inCommand coverage
Protection rules
3
Permission checks
3
Mapped commands
3

Overview

What this coverage does

Reviews seatbelt commands that remove or weaken the guardrail it installs for coding agents: removing its hook, installing it so a crashing hook fails open, and editing agent settings.

Key facts

Catalog ID
command.seatbelt-guard
Version
v1.0.0
Kind
Command coverage
Category
Other extensions
Protection rules
3
Permission checks
3
Mapped commands
3
Maintainer
Community contributor(community, provenance recorded)
Source commit
e2593fe
Protection model
External · opt-in
External · opt-in

External coverage. It must be enabled through Guard controls; this page does not activate it.

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.

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

3 operations3 reviewed
Default floor

Showing 3 of 3 operations

  • Reviewed Guard intercepts the command for review before it runs.High
    • seatbelt install claude-code --no-on-failure-block --write
    seatbelt install without fail-closed hook
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies `seatbelt install <agent> --no-on-failure-block --write`, which installs the hook without `onFailure: block`, so a crash or timeout of the hook lets every command run unchecked. xargs launches are blocked by Guard's wrapper floor.
    Documented safe variants
    seatbelt install without fail-closed hook helpskip this operation when they are the documented preview or help form.
    Permission ID
    command.seatbelt-guard.permission.install-fail-open
  • Reviewed Guard intercepts the command for review before it runs.High
    • seatbelt uninstall claude-code --scope project --write
    seatbelt hook removal
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies `seatbelt uninstall <agent> --write`, which removes seatbelt's PreToolUse hook from an agent's settings and turns the guardrail off. Without --write the command only previews the change. xargs launches are blocked by Guard's wrapper floor.
    Documented safe variants
    seatbelt hook removal helpskip this operation when they are the documented preview or help form.
    Permission ID
    command.seatbelt-guard.permission.uninstall-hook
  • Reviewed Guard intercepts the command for review before it runs.Medium
    • seatbelt install claude-code --scope user --write
    seatbelt agent settings change
    Default floor
    Reviewed by default. Guard intercepts the command for review before it runs.
    Detector mode
    review
    What it matches
    Identifies `seatbelt install <agent> --write`, which edits an agent's settings file (user, project or local scope) to add the seatbelt hook. A backup is kept, but the file changes. xargs launches are blocked by Guard's wrapper floor.
    Documented safe variants
    seatbelt agent settings change helpskip this operation when they are the documented preview or help form.
    Permission ID
    command.seatbelt-guard.permission.install-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.seatbelt-guard
Guard enforcement ID
command.seatbelt-guard
Source path
contributions/extensions/command.seatbelt-guard.json
Contribution digest
sha256…856c6c

Action classes

seatbelt agent settings change commandseatbelt fail-open install commandseatbelt hook removal command

Technical profile

Independent technical profile

Published revision 1
Marketing distribution: off.This profile has no audience, channel, or promotion controls.
Profile content digest
sha256:3b3a09cac2fadb0597ef8120d992c8c6903918db5acc5ffbf5ce44ee01b74b2f
Profile source SHA
9f92f1bd3abc9dec89ef6f20ec281d8c0bc49f65
Source version
1.0.0
Native source path
contributions/extensions/command.seatbelt-guard.json
Native extension ID
command.seatbelt-guard
Runtime extension ID
command.seatbelt-guard
Contribution digest
sha256:627cf062a70f9ac68d626a13f86f982e07c5446b1ee344cd74ddb49213856c6c
Source contract fingerprint
sha256:89e886c76b7cad901ef997c1a0f4957abd7b515c49f3d33efa53339da59ccc80

Native contribution

Supported by reviewed source projection

Source version

Supported by reviewed source projection

Runtime capability

Supported by reviewed source projection

Permissions

Supported by reviewed source projection

The reviewed catalog declares 3 extension permission(s).

Harness support

Unknown / self-reported

Not tested against a specific agent harness. The fixture evaluates command strings (53 cases) and does not run any agent. seatbelt itself installs a hook for Claude Code.

Prerequisites

Unknown / self-reported

Guard with this extension enabled. To use seatbelt itself you need the seatbelt-guard package from PyPI (version 0.1.5 was reviewed).

Expected outcomes

Unknown / self-reported

Guard shows a review on seatbelt uninstall --write and install --write, and a policy_bypass (high) review on fail-open installs. Without --write (previews) and help commands are not flagged. Shortened options such as --wr and --no-on are matched.

Limitations

Supported by reviewed source projection

Limitations are copied from the reviewed catalog facts. Contributor-supplied limitation notes are not independently verified. Launches through python -m seatbelt, pipx run or uvx are not matched. Pinned to seatbelt 0.1.5; options added later are not covered. Stop or remove: Disable the extension in Guard and its rules stop matching. If you only disable one permission, matching commands are blocked instead of reviewed.

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

Residual effects

Unknown / self-reported

Contributor-supplied residual-effect text is not independently verified. Disabling the extension changes only Guard's rules. It does not touch the seatbelt hook or any agent settings file, and it does not undo anything seatbelt already did.

Release evidence

Unknown / self-reported

Accepted contributors recorded in the reviewed catalog: @nikhilrai-tech (author).

Controlled fixture proof (separate)

Unknown / self-reported

Contributor assertion is not an authoritative fixture receipt. No controlled fixture procommand-source-seatbelt-guard.v1of has been supplied.

Exact installation and activation guide

Commands are copied only when the reviewed source supplies an exact argv contract. Other guidance is labeled unknown and is not executed by this page.

Install

Unknown / self-reported

The source ships in HOL Guard's extension catalog and is opt-in, so it needs no separate install. seatbelt itself is installed separately: pipx install seatbelt-guard (or pip install seatbelt-guard).

Activation

Unknown / self-reported

The extension is opt-in: it stays off until you enable it in Guard. Once on, its three rules are in review mode by default.

Safe fixture inputs

Unknown / self-reported

With the extension enabled, in a throwaway project, have the agent propose "seatbelt uninstall claude-code --write" and decline when Guard asks for review. Do not approve it: approving would really remove the hook.

Disable / remove

Contributor-reported support

Disable the extension in Guard and its rules stop matching. If you only disable one permission, matching commands are blocked instead of reviewed.

FAQ

Frequently asked questions

Reviews seatbelt commands that remove or weaken the guardrail it installs for coding agents: removing its hook, installing it so a crashing hook fails open, and editing agent settings. The listing declares 3 rules and 3 permission checks. 3 operations · 3 reviewed by default. Coverage is limited to these reviewed operations and the surrounding Guard policy.

External · opt-in: External coverage. It must be enabled through Guard controls; this page does not activate it. Enabling state is always controlled through Guard policy, never from this directory.

This listing entered the catalog as a community contribution through a public pull request with recorded provenance, with public credit to @nikhilrai-tech, and 1 GitHub maintainer is recorded on the listing. Credit is attribution only. A verified publisher profile and the claim flow verify authority separately; neither is an upstream endorsement or a HOL safety certification.

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.

3 operations · 3 reviewed by default. Examples: seatbelt install claude-code --no-on-failure-block --write (reviewed by default); seatbelt uninstall claude-code --scope project --write (reviewed by default); seatbelt install claude-code --scope user --write (reviewed by default). These are catalog defaults, not your workspace policy.

External coverage. It must be enabled through Guard controls; this page does not activate it. 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.seatbelt-guard 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 3 rules and 3 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 extensions are merged through public pull requests with recorded provenance, and you can claim the publisher page for a contribution you maintain through the Publisher Studio.

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.