Skip to content

jackiesafari/kiroween

Repository files navigation

⚡ GitHub Graveyard Reanimator ⚡

A spooky tool that scans GitHub graveyards for abandoned projects and uses AI to literally bring them back to life. Paste in a dead repo, and it modernizes dependencies, refactors deprecated code, adds tests, and generates updated documentation.

🧟 Features

  • AI-Powered Analysis: Uses OpenAI to generate intelligent, context-aware fixes
  • Dependency Resurrection: Updates outdated packages and fixes security vulnerabilities
  • Configuration Modernization: Generates TypeScript configs, ESLint, and Prettier setups
  • Test Generation: Creates comprehensive test suites with CI/CD pipelines
  • Documentation Revival: Regenerates README files with proper structure
  • Code Quality Enhancement: Converts JavaScript to TypeScript with proper types
  • Downloadable Fixes: Export all generated files to apply to your repo

🎃 The Spooky Experience

Watch the dramatic reanimation process with:

  • ⚡ Lightning effects during reanimation
  • 💀 Body parts (modules) tracking showing what needed the most work
  • 🌟 Animated background with floating particles
  • 🎨 Purple and pink gradient theme with glow effects

🚀 Getting Started

npm install
npm run dev

Open http://localhost:3000 to see the reanimator in action.

🔮 How It Works

  1. Enter a GitHub repository URL
  2. Click "Begin Reanimation"
  3. AI analyzes the repo using GitHub API
  4. Watch as each module is analyzed and brought back to life with lightning effects
  5. View AI-generated fixes and code for each component
  6. Download all generated files to apply to your repo

🔑 Setup

Create a .env file with your API keys:

GITHUB_TOKEN=your_github_token_here
OPENAI_API_KEY=your_openai_api_key_here

Get your tokens:

🛠️ Tech Stack

  • Next.js 16
  • React 19
  • TypeScript
  • Tailwind CSS 4

📝 Future Enhancements

  • Automatic PR creation with all fixes
  • Support for Python, Go, Rust, and other languages
  • Batch processing for multiple repos
  • Integration with npm audit for security scanning
  • Real-time collaboration features
  • Custom AI prompts for specific modernization needs

🎭 Made for Kiroween

This project was created as a spooky Halloween-themed developer tool.

About

A spooky tool that scans GitHub graveyards for abandoned projects and uses AI to literally bring them back to life. Paste in a dead repo, and it modernizes dependencies, adds tests, and more

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors