Code Whisperer Time Machine

Code Whisperer Time Machine uses Amazon Q to modernize legacy code, explain commit history, and auto-generate clean, documented, cloud-ready code — turning legacy into living systems.

Comment

🚀## Code Whisperer Time Machine 🧭 Project Overview Code Whisperer Time Machine is an AI-powered tool designed to help developers modernize legacy codebases, understand historical changes, and convert them into clean, maintainable, and cloud-ready services. It uses the capabilities of Amazon Q Developer and large language models to extract meaning, intent, and structure from old code and Git commit history — turning static code into dynamic, explainable assets.

Whether you’re dealing with COBOL, Java, or other legacy systems, this tool acts as your AI companion to: Translate outdated code into modern languages like Python or Go Explore commit history with human-like explanations Document code automatically with architecture diagrams and changelogs Refactor legacy monoliths into modular or serverless architectures using AWS CDK

🎯 Problem It Solves Legacy code still powers critical infrastructure in finance, healthcare, and government. But it's: Hard to read and understand Poorly documented Risky to refactor

Full of institutional knowledge that lives only in commit history or people's heads

Code Whisperer Time Machine addresses these challenges by combining AI-generated insights with Git timeline analysis to reveal the story behind the code and suggest a safer path forward.

🛠️ How It Works

  1. Ingest Load a legacy repository (e.g., COBOL, Java, PHP, Perl) Analyze Git commit history and diff patterns

  2. Analyze Use Amazon Q + GPT to summarize commit intent (“why” it changed, not just “what”) Identify legacy patterns and anti-patterns in the code

  3. Visualize Display a “Time Machine” UI: an interactive Git timeline with AI summaries Visual diffs, file heatmaps, and commit clustering

  4. Modernize Suggest modular refactoring (e.g., convert to microservices, serverless functions) Translate old code into modern languages with inline explanations Generate CDK infrastructure for deployment (e.g., Lambda, API Gateway)

  5. Deliver Output modernized codebase Auto-generate documentation: READMEs, changelogs, Mermaid diagrams Package infrastructure-as-code (IaC)

✨ Key Features 🕰 Time Explorer: Navigate and understand commit history using natural language 🧠 Commit Whispering: Understand developer intent behind past changes 🔁 Code Translator: Convert legacy code into Python/TypeScript/Go 📄 Auto-Documentation: Generate docs, diagrams, and changelogs ☁️ CDK Export: Output deployable AWS infrastructure 🔍 Searchable History: Search codebase evolution by feature or bugfix 🔍 Example Use Case Before (COBOL logic):

IF INCOME < 10000  
    MOVE 0 TO TAX  
ELSE  
    COMPUTE TAX = INCOME * 0.2

After (Python function with CDK hook):

def calculate_tax(income: float) -> float:
    return 0 if income < 10000 else income * 0.2

Deployed as AWS Lambda CDK defines infra Mermaid.js documents logic flow

🧪 Technologies Used Component Stack AI/NLP Amazon Q Developer, OpenAI GPT Frontend React, Tailwind CSS, Mermaid.js Backend Python (FastAPI), Git CLI parsing Infra-as-Code AWS CDK, Lambda, S3, Step Functions Visualization D3.js, Mermaid.js

📦 Ideal For Legacy modernization teams DevOps and SREs needing code intelligence Developers inheriting old, undocumented code Organizations looking to move from monoliths to cloud-native microservices

📈 Outcomes ✅ Faster developer onboarding ✅ Reduced time spent understanding legacy systems ✅ Safer refactoring with AI-backed guidance ✅ Modernized code with infrastructure ready for CI/CD

📅 Roadmap Chat-based interface to query code history Multi-repo correlation for large systems GitHub app to comment on pull requests with context Integration with Amazon CodeCatalyst

🧠 Summary Code Whisperer Time Machine helps you look backward to move forward. It breathes new life into legacy codebases by transforming static, cryptic history into actionable, AI-powered insights and modernization blueprints.

If you're tired of fearing old code… It's time to give your past the future it deserves.

Built With

  • amazon-web-services
  • cdk
  • d3.js-backend-logic-python-(fastapi/flask)
  • docker
  • frontend-ui-react
  • gitpython-(python)-infra-as-code-aws-cdk-(typescript-/-python)-deployment-docker
  • node.js-ai-integration-amazon-q-developer
  • openai-(python)-version-control-git-cli
  • python
  • tailwind-css-diagrams-&-visuals-mermaid.js
  • typescript
  • vercel
Share this project:

Updates