Back to the collection
GuardrailsPublic source

Blast Radius.

Install Blast Radius for Claude Code to preview supported risky Bash commands, then choose Proceed or Cancel. Learn its display requirements and limits.

By Claude Code DevRelReviewed 2026-10-13
● ● ●claude / blast-radius
❯ rm -rf build
◇ Before you proceed
build/index.js 12 KB
build/assets/ 248 KB
CancelProceed ↗
UI illustration

What it does

Pause supported destructive shell commands and review the affected files or commits before choosing Proceed or Cancel. The sample demonstrates an interactive tool-call guard.

  • Preview affected files and commits
  • Proceed and Cancel controls
  • Compact layout for narrow terminals

How to install Blast Radius

This is the sample in Anthropic’s claude-code-playground. Forks with the same name can have different setup and behavior. The author requires Claude Code 2.1.287+ and bash, git, find and du on your PATH; migration previews also need the project’s migration tool.

After reading the source, use these author-documented shell commands to validate and load it for one session:

INSTALL / TERMINAL
git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods
claude plugin validate ./blast-radius
claude --plugin-dir ./blast-radius

For persistent installation, run the following from the same mods directory:

INSTALL / TERMINAL
claude plugin marketplace add ./
claude plugin install blast-radius@claude-code-playground-mods --scope user

Remove that installation with claude plugin uninstall blast-radius@claude-code-playground-mods --scope user. For loading errors, see the installation checklist.

What it holds, and how to answer

The README describes previews for recognized deletion commands, hard resets, checkout/restore, git clean, force pushes and migrations. Press 1 to proceed or 2 to cancel, or use the buttons. Cancel starts focused. Esc or ten minutes without an answer refuses the command.

Why is there no side pane?

The author recommends roughly 144 terminal columns for the pane. Narrower terminals use the band above the prompt, where keyboard choices require empty input. Another mod using that band can hide the controls; widen the terminal or disable the competing display.

Does it catch every destructive action?

No. It watches Bash, not file-edit tools, and misses aliases, scripts and several shell wrappers. Only the first risky segment is measured; approval runs the entire command line. Keep permission rules for hard restrictions.

What can a preview miss or run?

Deletion counts are approximate and show only the first ten files. Force-push comparisons use the last fetched remote state. Migration status commands load project code before your decision. The report is additional information, not a sandbox or proof of safety.

Source-reviewed October 13, 2026; CC Mods has not executed the sample. The author’s README distinguishes earlier live tests from later fixes checked with a stand-in. Browse guardrail mods for related ideas.

When this mod might be useful

Blast Radius may help when a task involves deleting generated files, resetting work, cleaning a repository, or applying another supported command with a large impact. The preview gives you another opportunity to inspect the target. It is most useful when you also understand the command and the mod’s documented pattern-matching limits.

Understanding this listing

Use this listing as a starting point for comparing the author’s documented behavior with your own workflow. The repository is the source of truth for installation, configuration, and later changes. The commands here reflect the setup available at the review date.

Before you try it

  • The source lists supported command patterns and important blind spots; this is not a complete shell parser.
  • Requires Claude Code 2.1.287 or later.