Intelligent repository cleanup with auto mode, AI learning, markdown consolidation, auto-consolidate workflow, context-aware classification, and cost optimization
Repository cleanup utility for vibe coding sessions
Stop the chaos after intense AI-assisted coding sessions. UnVibe intelligently organizes your repositories, respects git boundaries, and keeps your monorepos clean.
When running devibe --auto without AI configured, you'll now get a helpful prompt:
⚠️ No AI API key configured
Auto mode works best with AI classification for accurate results:
• With AI: 90% accuracy
• Without AI: 65% accuracy (heuristics only)
To enable AI classification, add an API key:
devibe ai-key add anthropic <your-key> # Recommended: Claude
devibe ai-key add openai <your-key> # Alternative: GPT-4
devibe ai-key add google <your-key> # Budget: Gemini
Continue with heuristics only? (y/n):
Features:
Fully automated markdown consolidation workflow that respects git repository boundaries!
# Auto-consolidate current directory (respects git boundaries)
devibe consolidate:auto
# Process monorepo - each nested repo processed independently
devibe consolidate:auto /path/to/monorepo
# With options
devibe consolidate:auto --max-output 3 --suppress-toc
Key Features:
.devibe/Perfect for:
Advanced AI-powered markdown consolidation for interactive workflows.
✅ Mono-repo friendly - Respects multiple .git boundaries
✅ Secret detection - Scans for 31 types of hardcoded secrets (API keys, tokens, credentials)
✅ 100% reversible - All operations backed up automatically with restore capability
✅ Build validation - Ensures cleanup doesn't break builds (Node.js, Docker, Python, Go)
✅ Dry-run mode - Preview changes before applying across all commands
✅ Multi-provider AI - Support for Anthropic Claude, OpenAI GPT, Google Gemini (7 models)
✅ 90% accuracy - AI-powered file classification with context awareness
✅ Learning system - Learns from corrections and improves over time
✅ Cost optimization - 98% savings with smart model selection (Gemini Flash vs Claude Sonnet)
✅ Secure keys - AES-256 encrypted API key storage in ~/.devibe/
✅ Auto mode - One-command cleanup: devibe --auto or devibe yolo
✅ Intelligent classification - Multi-stage: learning → structure → dependencies → AI
✅ GitIgnore management - Auto-excludes .devibe/ and .unvibe/ directories
✅ GitHub integration - Pre-push hooks and Actions for CI/CD
✅ Progress tracking - Real-time feedback with detailed status updates
✅ 8 test categories - unit, integration, e2e, tdd, functional, performance, acceptance, contract
✅ 6 technology stacks - Node.js, React, Python, Go, Java, .NET/C#
✅ Smart detection - Automatic pattern matching and categorization
✅ Organization reports - Detailed breakdown by category and technology
✅ Best practices analyzer - 40+ automated checks across 8 categories
✅ Rule packs - Shareable directory structure standards (YAML/JSON)
✅ Weighted scoring - 0-100 quality score with severity levels
✅ Auto-fix detection - Identifies issues that can be automatically resolved
✅ CI/CD ready - JSON output for automation pipelines
✅ Markdown consolidation - AI-powered doc organization with topic clustering
✅ Relevance analysis - Multi-factor scoring (recency, quality, connectivity)
✅ Smart strategies - Merge, summarize, archive, or create navigation hub
✅ Content preservation - Validation and backup with rollback capability
✅ Non-intrusive UX - Smart prompting (max 2 times, then silent)
✅ Folder enforcement - Maintains scripts/ and documents/ structure
✅ Helpful recommendations - Context-aware suggestions for improvements
✅ Comprehensive docs - 20+ guides covering all features and workflows
# Install globally
npm install -g devibe
# Or use with npx (no installation)
npx devibe
devibe --version
# Should show: 1.8.7
devibe --help
# Shows all available commands
NPM Package: https://www.npmjs.com/package/devibe
# Quick auto-organize (recommended!)
devibe --auto
# or
devibe yolo
# Show repository status
devibe
# Scan for secrets before commit
devibe scan
# Plan file distribution
devibe plan
# Execute with backup
devibe execute
# Enforce folder structure
devibe enforce
# Validate builds
devibe validate
# Check repository best practices
devibe best-practices
# Validate a rule pack file
devibe validate-rulepack my-pack.json
# Consolidate markdown documentation (NEW in v1.7.0!)
devibe consolidate ./docs --dry-run
devibe or devibe statusShow repository status and suggested next actions.
devibe detectList all git repositories in the current directory.
devibe scanScan for hardcoded secrets (API keys, passwords, tokens).
Detects 31 types: AWS, Google, Azure, Stripe, GitHub, Slack, Discord, Anthropic, OpenAI, SendGrid, Twilio, Heroku, Firebase, NPM, Docker, Cloudflare, Datadog, and more. Plus JWT tokens, private keys, webhooks, and database credentials.
devibe planPlan root file distribution (shows what would be done).
devibe executeExecute planned file operations with automatic backup.
devibe execute --dry-run # Preview without making changes
devibe enforceEnforce folder structure (scripts/, documents/).
devibe validateDetect and validate build systems (Node.js, Docker, Python, Go).
devibe backupsList all available backups.
devibe restore <id>Restore from a backup.
devibe yolo or devibe --autoQuick auto-organize: Run full cleanup workflow automatically.
These commands are equivalent - use whichever you prefer!
What --auto does:
.gitignore to exclude .devibe/ directoriesPerfect for:
AI Key Handling:
devibe ai-key add <provider> <key> to configure AIdevibe ai-key reset-prompt⚠️ Note: This mode makes automatic changes but always creates backups first.
Quick commands:
devibe --auto # Quick auto-organize (same as yolo)
devibe yolo # Quick auto-organize (same as --auto)
devibe --auto --no-ai # Force heuristics only (skip AI prompt)
Advanced commands:
devibe plan --auto # Preview AI organization
devibe execute --auto # Execute AI organization
devibe execute --auto --no-ai # Execute with heuristics only
When to use:
devibe --auto or devibe yolo: Quick cleanup with AI (recommended)devibe --auto --no-ai: Fast cleanup without AI promptsdevibe plan --auto: Preview before executingdevibe initInitialize UnVibe configuration file.
devibe organize-testsOrganize test files by category (unit, integration, e2e, etc.).
devibe organize-tests # Move tests to organized directories
devibe organize-tests --dry-run # Preview changes
devibe organize-tests --report # Generate organization report
```0
### `devibe detect-tests`
List all test files and their categories.
### `devibe best-practices`
Analyze repository against industry best practices (40+ automated checks).
```bash
devibe best-practices # Run analysis
devibe best-practices --json # Output JSON for CI/CD
Checks include:
Scoring: Weighted 0-100 score with severity levels (critical, high, medium, low)
devibe validate-rulepackValidate a rule pack file against the specification.
devibe validate-rulepack my-pack.json
Provides clear, helpful error messages with:
$.metadata.name)devibe consolidateConsolidate markdown documentation using AI-powered semantic analysis.
# Preview consolidation (RECOMMENDED FIRST!)
devibe consolidate ./docs --dry-run
# Interactive consolidation
devibe consolidate ./docs -r
# Auto-consolidate with AI
devibe consolidate ./docs --auto -r --max-output 5
# Exclude patterns
devibe consolidate ./docs -r --exclude '**/archive/**' --exclude '**/old/**'
How it works:
DOCUMENTATION_HUB.md navigation hubConsolidation Strategies:
Relevance Scoring:
Safety Features:
--dry-run first to previewdevibe restoreOptions:
-r, --recursive - Process subdirectories--max-output <number> - Maximum consolidated files (default: 5)--dry-run - Preview without changes (RECOMMENDED)--auto - Auto-approve plan (use with caution)--exclude <pattern> - Exclude file patterns (repeatable)⚠️ Important: Requires AI to be enabled. Run devibe ai-key add <provider> <key> first.
devibe consolidate:autoNEW in v1.8.0+ Automated markdown consolidation workflow with intelligent organization.
# Basic usage (current directory)
devibe consolidate:auto
# With options
devibe consolidate:auto --max-output 3 --suppress-toc
# Exclude patterns
devibe consolidate:auto --exclude '**/node_modules/**' --exclude '**/archive/**'
# Specific directory
devibe consolidate:auto /path/to/project
Automated Workflow:
*.md files from root → <root>/documents/.devibe/backups/BACKUP_INDEX.md (date-sorted)Git-Aware (v1.8.2+):
Example with nested repos:
cd /monorepo
devibe consolidate:auto .
# Result:
# ✓ Processed 3 git repositories
# /monorepo/.git → documents/, consolidated files
# /monorepo/project-a/.git → documents/, consolidated files
# /monorepo/project-b/.git → documents/, consolidated files
Safety:
documents/devibe restoreOptions:
--max-output <number> - Maximum output files (default: 5)--suppress-toc - Suppress Table of Contents generation--exclude <pattern> - Exclude file patterns (repeatable)Use Cases:
⚠️ Important: Requires AI to be enabled. Run devibe ai-key add <provider> <key> first.
Manage AI providers, keys, and cost optimization.
devibe ai-key add <provider> <key>Add an AI API key (encrypted with AES-256).
devibe ai-key add anthropic sk-ant-...
devibe ai-key add openai sk-...
devibe ai-key add google AIza...
devibe ai-key statusShow current AI configuration and cost recommendations.
devibe ai-key status
# Shows active provider, model, and potential savings
devibe ai-key clearRevert to environment variables (removes configured keys).
devibe ai-key clear
# Falls back to ANTHROPIC_API_KEY or OPENAI_API_KEY
devibe ai-analyzeCompare AI models and costs for your repository.
devibe ai-analyze # Analyze current directory
devibe ai-analyze -f 5000 # Analyze for 5000 files
Shows cost comparison across 7 AI models:
devibe ai-modelsList all available AI models with pricing and context windows.
devibe ai-models
DeVibe can automatically organize your tests into logical categories:
tests/
├── unit/ # Unit tests
├── integration/ # Integration tests
├── e2e/ # End-to-end tests
├── tdd/ # TDD specs
├── functional/ # Functional tests
├── performance/ # Performance tests
├── acceptance/ # Acceptance tests
└── contract/ # Contract tests
Supports 6 technologies:
.test.ts, .spec.ts).test.tsx, __tests__/)test_*.py, *_test.py)*_test.go)*Test.java, *IT.java)*Tests.cs, *Test.cs, xUnit/NUnit/MSTest)Share and reuse directory structure standards across projects and teams.
# Install official rule pack
devibe rulepack install @devibe/nodejs-standard
# Use in your project
devibe --rulepack @devibe/nodejs-standard
# Or in .devibe.config.js
module.exports = {
rulepacks: ['@devibe/nodejs-standard']
};
@devibe/nodejs-standard - Standard Node.js structure@devibe/react-standard - React/Next.js conventions@devibe/nodejs-monorepo - NX/Turborepo monorepo structure@devibe/python-standard - Python best practices@devibe/go-standard - Go standard project layoutCreate your own shareable standards:
# my-company-standard.yaml
schema: "devibe-rulepack/v1"
metadata:
name: "@mycompany/engineering-standard"
version: "1.0.0"
structure:
requiredFolders:
- path: "src"
- path: "tests"
- path: "docs"
testOrganization:
enabled: true
categories:
- name: "unit"
patterns: ["**/*.test.ts"]
targetDirectory: "tests/unit"
See RULE_PACK_SPEC.md for complete specification.
Create .unvibe.config.js in your repository root:
module.exports = {
secretScan: {
excludePatterns: ['node_modules/**', '.git/**'],
},
folderStructure: {
requiredFolders: ['scripts', 'documents'],
},
ai: {
enabled: false,
provider: 'anthropic', // or 'openai'
},
backup: {
enabled: true,
retentionDays: 30,
}
};
For better file classification (90% vs 65%):
export ANTHROPIC_API_KEY=your-key-here
# or
export OPENAI_API_KEY=your-key-here
UnVibe automatically detects AI availability and provides helpful recommendations when features are unavailable.
UnVibe provides smart, context-aware recommendations for common issues:
$ devibe validate
✓ nodejs: PASSED (0ms)
⚠️ No build script found in package.json
Skipping build validation (not blocking)
To enable: Add "build": "tsc" or your build command to package.json scripts
$ devibe validate
✗ nodejs: FAILED (499ms)
💡 Build failed. Possible fixes:
• Run "npm install" to ensure dependencies are installed
• Check for TypeScript errors if using tsc
• Review build script in package.json
• Run "npm run build" manually to see full error
$ devibe plan
⚠️ AI classification unavailable - using heuristics (65% accuracy)
For better results: Set ANTHROPIC_API_KEY or OPENAI_API_KEY
$ devibe status
📊 UnVibe Status
AI Classification:
⚠️ AI unavailable - using heuristics (65% accuracy)
To enable: Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable
Build Configuration:
⚠️ No build script found
To enable validation: Add "build" script to package.json
The app never blocks on missing optional features - it provides helpful guidance while continuing to work.
UnVibe integrates with GitHub to keep your main branch clean:
# Setup git hooks (auto-runs on push)
devibe setup-hooks
# Check before pushing
devibe check-pr
Features:
See GITHUB-INTEGRATION.md for full guide.
All comprehensive documentation has been organized into the documents/ directory:
📚 View Full Documentation Index →
AI & Setup:
Architecture:
Reference:
💡 Tip: The documents/ folder contains 20+ guides. Check documents/README.md for the complete organized index.
npm install
npm test
npm run build
ISC License
UnVibe - Because every vibe coding session deserves a clean ending. 🚀
Made with Claude Code
FAQs
Intelligent repository cleanup with auto mode, AI learning, markdown consolidation, auto-consolidate workflow, context-aware classification, and cost optimization
The npm package devibe receives a total of 18 weekly downloads. As such, devibe popularity was classified as not popular.
We found that devibe demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Newer packages in this compromise use native extensions and .pth loaders to execute JavaScript stealers in developer environments.
Research
Socket found 37 malicious PyPI wheels that abuse Python startup hooks to launch a Bun-powered credential stealer tied to Mini Shai-Hulud/Miasma.
Security News
RubyGems and Bundler 4.0.13 introduced an opt-in cooldown feature that delays newly published gems during dependency resolution.