git404hub

what is vibe-guardrails fr?

rwgb/vibe-guardrails — explained in plain English

Analysis updated 2026-05-18

1ShellAudience · vibe coderComplexity · 2/5LicenseSetup · easy

tl;dr

Vibe-guardrails is a Claude Code plugin that gives non-engineers safety habits for AI-assisted coding, including git save points, project memory, a done checklist, secret scanning, and a hook that blocks destructive commands.

vibe map

mindmap
  root((vibe guardrails))
    What it does
      Save points
      Project memory
      Before you build check
      Done checklist
      Secret scanning
    Tech stack
      Shell
      Claude Code plugin
      Git
    Use cases
      Prevent destructive commands
      Track project context
      Avoid leaked secrets
    Limitations
      Not a security audit
      Not an education
      Hook fails open

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Add git-based save points to an AI-coding project so you can roll back after a risky change.

VIBE 2

Keep a persistent project memory log so each new AI coding session has context.

VIBE 3

Get warned before Claude Code runs a command that could destroy your work, like a force push or hard reset.

what's the stack?

ShellClaude CodeGit

how it stacks up fr

rwgb/vibe-guardrails100/dotfilesabdellaouiamir/palworld-server
Stars111
LanguageShellShellShell
Last pushed2016-11-18
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencevibe coderdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install via two Claude Code plugin commands, then restart Claude Code to load the hook and skills.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

Vibe-guardrails is a plugin for Claude Code, the AI coding assistant, aimed at people who build real projects with AI help but do not have a traditional software engineering background. It adds a set of basic safety habits that experienced engineers already know, so that AI-assisted coding stays recoverable when things go wrong. The plugin includes five skills and one safety hook. The save-points skill teaches you to create git checkpoints before risky changes, so you can always roll back. The project-memory skill keeps a running log file so each new coding session starts with context instead of starting from scratch. The before-you-build skill runs a short check for what could go wrong before you start building something non-trivial. The done-checklist skill gives you a concrete definition of what counts as finished, rather than stopping once something merely runs on your machine. The keep-secrets-secret skill checks for API keys and credentials before they end up committed to your code or git history. The safety hook watches every shell command Claude Code is about to run and blocks a short list of commands that would permanently destroy work, such as force pushes, hard resets, and recursive deletes on risky paths. When it blocks a command, it explains what would have been destroyed and suggests what to do instead. Installing it takes two commands inside Claude Code to add the plugin marketplace and install the plugin, followed by a restart so the hook and skills load. During installation you will see a trust prompt, since the plugin runs a small shell script before each command, the entire plugin is plain text in the repository, so you can review it before agreeing. The author is upfront about its limits. It is not a full security audit, since the secrets check only catches common patterns like API keys and passwords. It is not a substitute for learning software engineering fundamentals. The safety hook is best effort: it recognizes a specific list of destructive commands and deliberately allows anything it does not recognize to pass through, rather than risk blocking something that should work. Save points remain the real safety net. The project is written mostly in Shell script and is released under the MIT License.

prompts (copy fr)

prompt 1
Set up save points for this project so I can roll back if something breaks.
prompt 2
Create a PROJECT_LOG.md for this project so future sessions have context.
prompt 3
Check this project for secrets before I commit.
prompt 4
Walk me through installing the vibe-guardrails plugin and what the trust prompt means.

Frequently asked questions

what is vibe-guardrails fr?

Vibe-guardrails is a Claude Code plugin that gives non-engineers safety habits for AI-assisted coding, including git save points, project memory, a done checklist, secret scanning, and a hook that blocks destructive commands.

What language is vibe-guardrails written in?

Mainly Shell. The stack also includes Shell, Claude Code, Git.

What license does vibe-guardrails use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is vibe-guardrails to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is vibe-guardrails for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.