Bring dead code back to life with intelligent modernization, dependency resurrection, and real-time visualization.

Live Demo: https://codecrypt-demo.netlify.app

CodeCrypt is an autonomous AI agent that resurrects abandoned software projects. It combines deep code analysis with cutting-edge visualization to transform the complex process of modernizing legacy code into an engaging, interactive experience.

• 🔍 Death Detection: Identifies outdated dependencies, security vulnerabilities, and deprecated APIs
• 🤖 Hybrid Analysis: Combines AST parsing with LLM semantic understanding
• 🔄 Smart Updates: Intelligently resolves dependencies with dead URL detection and replacement
• 📊 Live Dashboard: Real-time metrics with animated charts
• 🏙️ 3D Ghost Tour: Interactive code city visualization showing project evolution
• 🎵 Resurrection Symphony: Music that evolves with code quality
• 🗣️ AI Narration: Voice commentary explaining each step
• 🐳 Time Machine Validation: Docker-based testing proving functional equivalence

• Node.js 16+
• VS Code 1.106.1+
• Docker (optional, for Time Machine validation)
• API key for Anthropic Claude or Google Gemini

1. Install the VS Code Extension

   cd codecrypt
   npm install
   npm run compile

2. Configure LLM Provider

   • Open VS Code Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
   • Run: CodeCrypt: Configure Anthropic API Key or CodeCrypt: Configure Gemini API Key
   • Enter your API key

3. Start a Resurrection

   • Command Palette → CodeCrypt: Resurrect Repository
   • Enter a GitHub repository URL
   • Watch the resurrection happen in real-time!

4. View the Dashboard

   • Local: http://localhost:3001 (when backend is running)
   • Production: https://codecrypt-demo.netlify.app

codecrypt-kiro/
├── codecrypt/                    # VS Code Extension (Backend)
│   ├── src/
│   │   ├── extension.ts         # Extension entry point
│   │   ├── services/            # Core resurrection services
│   │   │   ├── resurrectionOrchestrator.ts
│   │   │   ├── dependencyAnalysis.ts
│   │   │   ├── hybridAnalysis.ts
│   │   │   ├── sseServer.ts     # Real-time event streaming
│   │   │   └── ...
│   │   └── test/                # Comprehensive test suite
│   ├── frontend/                # React Dashboard (Frontend)
│   │   ├── src/
│   │   │   ├── components/      # Dashboard, GhostTour, Symphony, Narrator
│   │   │   ├── context/         # State management
│   │   │   ├── hooks/           # Custom React hooks
│   │   │   └── utils/           # Visualization utilities
│   │   ├── dist/                # Production build
│   │   └── netlify.toml         # Netlify deployment config
│   ├── data/                    # Package replacement registry
│   └── package.json
├── .kiro/
│   ├── specs/                   # Feature specifications
│   └── steering/                # Development guidelines
└── README.md                    # This file

1. Start Resurrection

   VS Code → Command Palette → CodeCrypt: Resurrect Repository
   

2. Monitor Progress

   • Watch the VS Code progress indicator
   • Open http://localhost:3001 for live dashboard
   • Listen to AI narration explaining each step
   • Explore the 3D Ghost Tour visualization

3. Review Results

   • Check the resurrection report
   • Review updated dependencies
   • Validate with Time Machine tests
   • Commit the modernized code

cd codecrypt
npm install
npm run compile        # Compile TypeScript
npm test              # Run tests
npm run watch         # Watch mode for development

cd codecrypt/frontend
npm install
npm run dev           # Start dev server on http://localhost:5173
npm run build         # Production build
npm test              # Run tests

cd codecrypt/frontend
npm run build
netlify deploy --prod

CodeCrypt uses a dual-stream architecture:

Death Detection → Hybrid Analysis → Planning → Resurrection → Validation

SSE Events → State Management → Real-time Visualization

Backend (VS Code Extension)

• TypeScript
• Octokit (GitHub API)
• Anthropic SDK / Google Generative AI
• Babel & ts-morph (AST parsing)
• Docker SDK

Frontend (Dashboard)

• React 18
• Three.js (3D visualization)
• Chart.js (metrics dashboard)
• Tone.js (audio synthesis)
• Web Speech API (narration)
• Vite (build tool)

Real-time animated charts showing:

• Dependencies updated
• Vulnerabilities fixed
• Code complexity trends
• Test coverage
• Lines of code changes

Interactive code city where:

• Files are buildings (height = LOC)
• Colors indicate change frequency
• Timeline slider shows evolution
• Click buildings to see details

Voice commentary that explains:

• Current resurrection step
• Why changes are needed
• Progress and status
• Errors and warnings

Dynamic music that reflects:

• Code quality metrics
• Complexity reduction
• Test coverage increase
• Overall project health

Before/after comparison showing:

• Original compilation state
• Modernized compilation state
• Build success/failure
• Error counts

• API keys stored securely using VS Code SecretStorage
• Keys never logged or exposed in code
• Environment variables sanitized
• MCP server credentials validated
• No data sent to external services except configured LLM providers

• Ensure you've started a resurrection in VS Code
• The backend SSE server runs on port 3000 when resurrection is active
• Frontend connects to http://localhost:3000/events

1. Run CodeCrypt: Configure Anthropic API Key or CodeCrypt: Configure Gemini API Key
2. Enter your API key
3. Restart VS Code

1. Review the resurrection report for errors
2. Check removed/updated dependencies
3. Run npm install manually
4. Review breaking changes in updated packages

• Check browser console for connection errors
• Verify backend is running (extension is active)
• Ensure no firewall blocking localhost:3000

• VS Code Extension README
• Frontend README
• Development Strategy
• Spec Overview
• Demo Guide

We welcome contributions! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (npm test)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

• Follow TypeScript best practices
• Write tests for new features
• Update documentation
• Follow the spooky/gothic theme 🎃
• Use async/await for async operations
• Add JSDoc comments for public APIs

MIT License - see LICENSE file for details

CodeCrypt was created for the Kiroween Hackathon with a "resurrection" theme. The project embraces a spooky/gothic aesthetic throughout its naming, UI/UX, and documentation.

• Built with Kiro - AI-powered development environment
• Powered by Anthropic Claude and Google Gemini
• Visualization powered by Three.js, Chart.js, and Tone.js
• Deployed on Netlify

• 🐛 Report a Bug
• 💡 Request a Feature
• 📧 Contact: olaoluwamercydeborah@gmail.com

Made with 💀 and ❤️ for the Kiroween Hackathon

Bringing dead code back to life, one repository at a time.