Vibe and Thrive

Tools and guardrails that catch common AI coding mistakes before they hit your codebase.

Whether you're using AI coding agents or building your own agents, MCPs, or applications—these tools catch patterns that lead to technical debt automatically.

Install

# Using uv
uv pip install vibe-and-thrive

# Using pip
pip install vibe-and-thrive

Then run the setup script to install Claude Code skills, pre-commit hooks, and templates:

git clone https://github.com/allthriveai/vibe-and-thrive.git
./vibe-and-thrive/setup-vibe-and-thrive.sh ~/path/to/your-project

Usage

Claude Code (recommended)

Run /vibe-check in Claude Code for a full code quality audit:

/vibe-check

This scans your codebase for secrets, debug statements, empty catches, deep nesting, long functions, and more.

CLI

vibe-check-secrets src/         # Hardcoded secrets
vibe-check-urls src/            # Localhost URLs
vibe-check-nesting src/         # Deep nesting
vibe-check-length src/          # Long functions

Pre-commit (automatic)

Runs automatically on every commit. See Pre-commit Hooks below.

What's Included

Claude Code Skills

Also Included

Pre-commit Hooks

Add to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/allthriveai/vibe-and-thrive
    rev: v0.3.0
    hooks:
      - id: check-secrets           # BLOCKS commits
      - id: check-hardcoded-urls    # BLOCKS commits
      - id: check-debug-statements  # Warns
      - id: check-empty-catch       # Warns
      - id: check-any-types         # Warns
      - id: check-deep-nesting      # Warns
      - id: check-function-length   # Warns

Then: pre-commit install

See docs/HOOKS.md for all 16 hooks.

Documentation

Philosophy

These are guardrails, not gatekeepers:

• Warn about most issues (awareness > blocking)
• Block only security-critical problems
• Support # noqa: suppression
• Little and often make much
• Sleep, code, test, code, sleep, repeat

License

MIT - see LICENSE

Built by AllThrive AI for the vibe coding community.