$git clone https://github.com/GraeLefix/GITVERSEReverse engineer any codebase into a build prompt.
| 1 | <div align="center"> |
| 2 | |
| 3 | # GITVERSE |
| 4 | |
| 5 | **Reverse engineer any codebase into a build prompt.** |
| 6 | |
| 7 | Paste code → AI analyzes → Get a copy-paste-ready reconstruction prompt for Cursor, Claude, Codex, or any AI coding agent. |
| 8 | |
| 9 | [](http://gitverse.id/) |
| 10 | [](https://github.com/GraeLefix/GITVERSE/stargazers) |
| 11 | [](LICENSE) |
| 12 | [](https://nextjs.org) |
| 13 | [](https://www.typescriptlang.org) |
| 14 | |
| 15 | </div> |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## What is GITVERSE? |
| 20 | |
| 21 | **GITVERSE** is an AI-powered reverse engineering tool that turns any codebase into a structured build prompt you can hand directly to an AI coding agent. |
| 22 | |
| 23 | Inspired by [gitverse.id](http://gitverse.id/) — the simplest way to understand and rebuild any code. |
| 24 | |
| 25 | --- |
| 26 | |
| 27 | ## How it works |
| 28 | |
| 29 | ``` |
| 30 | 01 — Paste your files → 02 — AI Analyzes → 03 — Get Build Prompt |
| 31 | ``` |
| 32 | |
| 33 | 1. **Paste code** — drop any files or GitHub URLs |
| 34 | 2. **AI analyzes** — full breakdown of architecture, dependencies, APIs, and business logic |
| 35 | 3. **Get prompt** — one exhaustive, copy-paste-ready reconstruction prompt |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Features |
| 40 | |
| 41 | | Feature | Description | |
| 42 | |---|---| |
| 43 | | 🧠 AI Analysis | Full breakdown of tech stack, files, APIs, and business logic | |
| 44 | | 📐 ASCII Blueprint | System architecture as ASCII diagram with components and data flows | |
| 45 | | 📋 Build Prompt | One exhaustive prompt with every file, exact dependencies, env vars, and deployment steps | |
| 46 | | 🔗 GitHub Integration | Paste any public GitHub URL and reverse engineer the entire repo | |
| 47 | | ⚡ Incremental Mode | Type `GITVERSE_DONE` after pasting multiple files to trigger batch analysis | |
| 48 | | 🌐 Multi-LLM Support | Works with Grok, OpenRouter, Azure OpenAI, Google AI Studio | |
| 49 | | 🔒 Privacy First | Your code is never stored permanently | |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## Tech Stack |
| 54 | |
| 55 | - **Framework**: [Next.js 16](https://nextjs.org) (App Router) + React 19 |
| 56 | - **Language**: TypeScript 5 |
| 57 | - **Styling**: Tailwind CSS 4 |
| 58 | - **AI Providers**: Grok (xAI), OpenRouter, Azure OpenAI, Google AI Studio |
| 59 | - **Database**: Supabase (optional — for prompt caching) |
| 60 | - **Payments**: Stripe (optional — for premium features) |
| 61 | - **Analytics**: Vercel Analytics |
| 62 | |
| 63 | --- |
| 64 | |
| 65 | ## Getting Started |
| 66 | |
| 67 | ### Prerequisites |
| 68 | |
| 69 | - Node.js 18+ |
| 70 | - pnpm or npm |
| 71 | - At least one LLM API key (see [Configuration](#configuration)) |
| 72 | |
| 73 | ### Installation |
| 74 | |
| 75 | ```bash |
| 76 | git clone https://github.com/GraeLefix/GITVERSE.git |
| 77 | cd GITVERSE |
| 78 | pnpm install |
| 79 | cp .env.example .env.local |
| 80 | # Fill in your LLM API key |
| 81 | pnpm dev |
| 82 | ``` |
| 83 | |
| 84 | Open [http://localhost:3000](http://localhost:3000) and start reversing code. |
| 85 | |
| 86 | --- |
| 87 | |
| 88 | ## Configuration |
| 89 | |
| 90 | Copy `.env.example` to `.env.local` and fill in at least one LLM API key. |
| 91 | |
| 92 | ### LLM Providers (at least one required) |
| 93 | |
| 94 | | Provider | Env Key | Default Model | |
| 95 | |---|---|---| |
| 96 | | Grok (xAI) | `XAI_API_KEY` | grok-3 | |
| 97 | | OpenRouter | `OPENROUTER_API_KEY` | google/gemini-2.5-pro | |
| 98 | | Azure OpenAI | `AZURE_OPENAI_API_KEY` + `AZURE_OPENAI_BASE_URL` | gpt-5.4 | |
| 99 | | Google AI Studio | `GOOGLE_GENERATIVE_AI_API_KEY` | gemini-2.5-pro | |
| 100 | |
| 101 | Set `GITREVERSE_QUICK_LLM` to pin a provider, or leave unset for `auto` mode (Grok → OpenRouter → Azure → Google). |
| 102 | |
| 103 | ### Optional Services |
| 104 | |
| 105 | ```env |
| 106 | # GitHub — increases API rate limits |
| 107 | GITHUB_TOKEN=ghp_... |
| 108 | |
| 109 | # Supabase — prompt caching & /library search |
| 110 | SUPABASE_URL=https://...supabase.co |
| 111 | SUPABASE_PUBLISHABLE_KEY=eyJ... |
| 112 | |
| 113 | # Stripe — premium features |
| 114 | STRIPE_SECRET_KEY=sk_... |
| 115 | STRIPE_PUBLISHABLE_KEY=pk_... |
| 116 | STRIPE_WEBHOOK_SECRET=whsec_... |
| 117 | ``` |
| 118 | |
| 119 | --- |
| 120 | |
| 121 | ## Project Structure |
| 122 | |
| 123 | ``` |
| 124 | GITVERSE/ |
| 125 | ├── app/ # Next.js App Router pages |
| 126 | │ ├── page.tsx # Home — paste code, get prompt |
| 127 | │ ├── [owner]/[repo]/ # GitHub URL routing (/vercel/next.js) |
| 128 | │ |