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
- 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 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.
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 commandTechnical profile
Independent technical profile
- 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 projectionSource version
Supported by reviewed source projectionRuntime capability
Supported by reviewed source projectionPermissions
Supported by reviewed source projectionThe reviewed catalog declares 3 extension permission(s).
Harness support
Unknown / self-reportedNot 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-reportedGuard 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-reportedGuard 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 projectionLimitations 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-reportedContributor-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-reportedAccepted contributors recorded in the reviewed catalog: @nikhilrai-tech (author).
Controlled fixture proof (separate)
Unknown / self-reportedContributor 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-reportedThe 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-reportedThe 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-reportedWith 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 supportDisable 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.