README.md
June 7, 2025 ยท View on GitHub
VibeSec
Security Rules & Workflows for Cursor and Windsurf AI assistants
Overview
VibeSec is an open-source project created by Untamed Theory that makes the new wave of AI development practices more secure across different AI coding tools. It provides a comprehensive set of security rules for both Windsurf and Cursor AI assistants to help developers write more secure code, following industry best practices.
What it does:
- Downloads security rules for Windsurf and Cursor development workspaces. Pretty Simple.
๐ก๏ธ Current Features:
- Supported AI assistants: Windsurf and Cursor
- Industry Standards: OWASP Top 10 to start (and we'll add more as we go). You can contribute too.
- Language-specific: Security hardening techniques for JavaScript, TypeScript, Python, and more
- Framework-focused: Targeted security recommendations for popular frameworks like React, Next.js, and Supabase
- AI-aware: Special considerations for LLM applications and AI-assisted development. Needs work. Help wanted.
๐ Quick Install
Apply VibeSec to your project with a single command:
# Auto-detect environment (defaults to Windsurf if detection fails)
curl -sL https://raw.githubusercontent.com/untamed-theory/vibesec/main/scripts/install.sh | bash
# Force Cursor installation
curl -sL https://raw.githubusercontent.com/untamed-theory/vibesec/main/scripts/install.sh | bash -s -- --cursor
# Force Windsurf installation
curl -sL https://raw.githubusercontent.com/untamed-theory/vibesec/main/scripts/install.sh | bash -s -- --windsurf
The installation script will automatically detect whether you're using Windsurf or Cursor and install the appropriate rules. If detection fails in a non-interactive environment (like when piped from curl), it will default to Windsurf.
๐ ๏ธ Cautious Installation
Not feeling lucky? You can always install VibeSec manually. Here's how:
# From the root of your project
# Clone the repository
git clone https://github.com/untamed-theory/vibesec.git
# Install the rules
./vibesec/scripts/install.sh
OR
Copy and paste the rules wherever and however you want. This is America after all.
โจ Features
๐ Unified Security RulesConsistent security guidelines that work seamlessly across both Windsurf and Cursor AI assistants. |
๐ Easy IntegrationGet started with a single command installation and zero configuration required. |
๐ Well DocumentedClear examples distinguishing secure vs. insecure patterns with practical code snippets. |
๐ ๏ธ Community-DrivenContinuously updated by security experts and the developer community. |
๐ Comprehensive Security Categories
frontend: CORS configuration, NextJS best practices, Supabase authentication, UI securitybackend: Rate limiting, API security, server-side validationdatabase: SQL injection prevention, Supabase hardening, data access controlsinfrastructure: Secrets management, configuration security, deployment safetyai: LLM prompt injection prevention, model security considerationssupply-chain: Dependency management, secure package selection, SBOMgeneral: OWASP Top 10, cross-cutting security concerns
๐๏ธ Directory Structure
vibesec/
โโโ definitions/ # Canonical security rule definitions
โ โโโ frontend/ # Frontend security rules
โ โโโ backend/ # Backend & API security rules
โ โโโ database/ # Database security rules
โ โโโ infrastructure/ # Infrastructure & DevOps security rules
โ โโโ ai/ # AI & LLM security rules
โ โโโ supply-chain/ # Supply chain security rules
โ โโโ general/ # Cross-cutting security principles
โโโ rules/ # Built rules for AI assistants
โ โโโ windsurf/ # Windsurf-formatted rules (.md)
โ โโโ cursor/ # Cursor-formatted rules (.mdc)
โโโ scripts/
โโโ install.sh # Installation script
โโโ build_rules.sh # Builds rules from definitions
๐ฅ Contributing
We welcome contributions from the community!
Contributing to VibeSec is easy:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-rule) - Create your security rule with these guidelines:
- All security rules start with the prefix
security- - Create a single canonical rule in the appropriate
definitions/directory - Include clear code examples showing both secure and insecure patterns
- Run
./scripts/build_rules.shto generate Windsurf and Cursor versions
- All security rules start with the prefix
- Commit your changes (
git commit -m 'Add amazing security rule') - Push to the branch (
git push origin feature/amazing-rule) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
โ๏ธ License
This project is licensed under the terms specified in the LICENSE file.