A friendly, transparent way to disclose AI assistance in your projects.
Not just a badge generator—this is about fostering transparency and trust in AI-assisted development. Easily add beautiful badges and disclosure notes that tell users which AI models helped create your code, maintaining open collaboration and honesty in the development community.
In the spirit of open collaboration and transparency, we believe developers should proudly disclose when AI tools have been used in their projects. Whether it's Claude, GPT, Gemini, or other models—transparency builds trust and helps others understand how your project was created.
This tool makes it effortless to:
- Disclose AI usage honestly with beautiful, professional badges
- Share model information so others know exactly what AI contributed
- Build trust with your users and the open source community
- Normalize AI transparency in software development
- One-Command Setup:
npx is-vibe-codedadds badge + disclosure to any repo - Model Disclosure: Clearly specify which AI company and model you used
- Flexible Placement: Choose where badge and note appear (header/footer/skip)
- Disclosure Presets: Professional, casual, or custom transparency messages
- Human Attribution: Acknowledge human contributors alongside AI
- Multiple Styles: Display, Banner, Square, and QR Code variants
- 6 Color Themes: Blue, Purple, Green, Orange, Red, and Gray gradients
- Scalable SVG: Vector format that looks perfect at any size
- Smart Layouts: Badge adapts based on which information you provide
- Zero Config: Works out of the box with sensible defaults
- CLI & Module: Use as command-line tool or Node.js library
- Web Interface: Also available as interactive web app
- Git Ready: Automatically prepares files for commit
The fastest way to add an AI transparency badge to your repository:
npx is-vibe-codedThis single command will:
- Run an interactive questionnaire
- Generate a beautiful badge
- Automatically inject it into your README.md
- Create README.md if it doesn't exist
Perfect for quickly setting up transparency disclosure in any repository!
Install globally via NPM:
npm install -g is-vibe-codedThen run in any repository:
is-vibe-codedOr use the alternative commands:
vibe-coded-icons
# or the shortest alias
vciInstall as a dependency:
npm install vibe-coded-iconsUse in your code:
import { generateBadge } from 'vibe-coded-icons';
const svg = generateBadge({
license: 'MIT',
size: 'medium',
color: 'blue',
humanName: 'Daniel Rosehill'
});
// Save to file or use in your applicationVisit: https://danielrosehill.github.io/Vibe-Coded-Icons/
- Clone this repository:
git clone https://github.com/danielrosehill/Vibe-Coded-Icons.git
cd Vibe-Coded-Icons- Open
index.htmlin your browser or run a local server:
python3 -m http.server 8000
# Then visit http://localhost:8000Perfect for inline README placement, sits nicely with other badges.
Larger, more prominent - great for top-of-page hero sections.
Flexible aspect ratio for sidebars, profile pages, or square placements.
Scannable badge that encodes:
- Model company and name
- License information
- Human contributor name
When you run vibe-coded-icons interactively, you'll be prompted for:
- License: Choose from popular open source licenses (MIT, Apache-2.0, GPL-3.0, etc.)
- Size: small, medium, or large
- Color: blue, green, purple, orange, red, or gray
- Human Name (optional): Your name or contributor name
- Disclosure Text (optional): Custom disclosure message
- Output Path: Where to save the badge (defaults to
badge.svg)
--defaultor-d: Use default options (MIT, medium, blue) for quick generation- Interactive mode (default): Guided prompts for all options
$ vci
🎨 Vibe-Coded Icons - AI License Badge Generator
? Which license did you use? MIT
? What size badge would you like? medium
? What color would you like? blue
? Human-friendly name for the license (optional):
? Disclosure text (optional, press enter for default):
? Output file path: my-badge.svg
✅ Badge generated successfully: my-badge.svg
License: MIT
Size: medium
Color: blueThe is-vibe-coded command is designed for instant repository setup. Instead of manually generating a badge and adding it to your README, this command does everything in one go.
You can use it without installation via npx:
npx vibe-coded-icons is-vibe-codedOr install globally and run:
npm install -g vibe-coded-icons
is-vibe-coded- Interactive Setup: Prompts you for badge preferences (license, size, color, etc.)
- Badge Generation: Creates
vibe-coded-badge.svgin your current directory - Flexible README Injection: You choose where to add content
- Badge location: Header, Footer, or Skip
- Disclosure note: Header, Footer, or None
- Finds existing README.md (case-insensitive)
- Creates README.md if none exists
- AI Transparency Note: Optional detailed disclosure section with:
- AI model information
- License details
- Human contributor acknowledgment
- Git Ready: Outputs next steps for committing and pushing
$ npx is-vibe-coded
🎨 Vibe-Coded Icons - Quick Setup for Your Repository
This will generate an AI transparency badge and add it to your README.
? 🤖 Which AI company created the model? Anthropic
? 🤖 Which AI model did you use? Claude Opus 4.5
? 💬 Choose disclosure text style: AI-Generated Code (default)
? 📄 Which license did you use? MIT
? 👤 Your name (human contributor, optional): Daniel Rosehill
? 📏 What size badge would you like? medium
? 🎨 What color would you like? blue
? 📍 Where should the badge be placed? Header (after first heading)
? 📝 Add a disclosure note to README? Yes, add note to footer
✅ Badge generated: vibe-coded-badge.svg
Model: Anthropic Claude Opus 4.5
Disclosure: AI-Generated Code
License: MIT
Size: medium
Color: blue
📄 Found existing README.md
✅ Badge added to header of README.md
✅ Disclosure note added to footer of README.md
🎉 All done! Your repository now has an AI transparency badge.
Next steps:
1. Review README.md to see the badge and disclosure note
2. Commit both README.md and vibe-coded-badge.svg to your repository
3. Push to GitHub to display the badge- New Projects: Quickly add transparency disclosure when starting a repository
- Existing Projects: Retrofit AI disclosure into mature projects
- Quick Documentation: One command to document AI assistance
- Team Onboarding: Easy for team members to add disclosure to their repos
Fill in the form fields:
- Model Company: e.g., "Anthropic", "OpenAI", "Google"
- Model Name: e.g., "Opus 4.5", "GPT-4", "Gemini Pro"
- License (optional): e.g., "MIT", "Apache 2.0"
- Human Name (optional): Your name or contributor name
Choose your style and gradient, then download as PNG or SVG!
# My Project
This project was built with assistance from AI...Place a square badge in your docs sidebar, or use a QR code at the end of printed documentation.
Add a banner badge to your GitHub profile or portfolio to show you embrace AI collaboration.
- Pure HTML/CSS/JavaScript - No build tools required
- Canvas API for badge rendering
- QRCode.js library for QR code generation
- Responsive Design - Works on mobile and desktop
MIT License - Feel free to use, modify, and distribute these badges!
Contributions welcome! Feel free to:
- Add new gradient themes
- Improve badge designs
- Add new badge styles
- Fix bugs or improve performance
Created by Daniel Rosehill to promote transparency in AI-assisted development.
AI is transforming how we write code, and that's something to celebrate—not hide. By being transparent about AI assistance, we:
- Build trust with users who deserve to know how their tools were made
- Share knowledge about what AI can (and can't) do well
- Normalize collaboration between humans and AI
- Encourage honesty in an industry that values openness
This isn't about shame or disclaimer—it's about pride in using the best tools available while being honest about our process.
- Website: danielrosehill.com
- Email: public@danielrosehill.com
- GitHub: @danielrosehill
Made with 💜 for transparent AI collaboration
