Skip to content

Latest commit

 

History

142 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UnvibeCode

Reverse engineer a complex codebase into business workflows, connected code, edge cases, and evidence-backed risks.

Unvibe complex code. Trace what the business actually does.

UnvibeCode AI codebase analysis demo showing connected code, business workflows, and risk findings

Quality checks PyPI version Python 3.11+ License

Your LLM helped write 100,000 lines of code. Now how do you understand what it actually built?

Reading files one by one does not show the complete business workflow. Pasting a large repository into an LLM can also lose the connections between entry points, state changes, dependencies, edge cases, and business outcomes.

UnvibeCode reverse-engineers a complex codebase into business workflows, connected code, edge cases, and evidence-backed risks.

Try UnvibeCode

Windows

python -m pip install --upgrade unvibecode
python -m unvibecode review --repository "D:\path\to\repository"

macOS / Linux

python3 -m pip install --upgrade unvibecode
python3 -m unvibecode review --repository "/path/to/repository"

No activation key. No customer OpenAI API key. The repository path is the only required input.

If UnvibeCode is useful for a codebase you need to understand, star the repository to save it for later.

One review. Four practical outputs.

1. Connected Code Map

See how files, symbols, imports, and calls work together. Select a file to trace its connected code and download a compact package for deeper LLM analysis.

Interactive code dependency graph showing connected files and downloadable LLM context

2. LLM-ready repository context

Stop manually selecting files or pasting unrelated code into an LLM. UnvibeCode prepares complete and connected repository context with filenames, line references, verified relationships, and reusable selections.

3. Business Workflow Map

A file tree explains repository structure. It does not explain how the software performs a business operation.

UnvibeCode reconstructs entry points, decisions, state changes, external calls, and business outcomes into understandable workflows.

Business workflow analysis connecting code paths to operational outcomes

4. Evidence-backed Business Risk Findings

UnvibeCode reviews completed workflows for failures that may materially affect customers, money, permissions, data integrity, operations, or other important business outcomes.

Each published finding includes the affected workflow and supporting code evidence.

Business risk finding with impact, remediation, acceptance check, and code evidence

Why UnvibeCode instead of stopping at code search, graphs, PR review, or LLM context?

Tools such as Probe, Graphify, PR-Agent / Qodo Merge, and Repomix solve useful parts of code understanding. UnvibeCode goes further by making the business workflow implemented across the repository the main unit of analysis.

Tool Strong at Where UnvibeCode goes further
Probe AST-aware code search, extraction, and code context for AI agents Search and retrieval help locate code; UnvibeCode reconstructs the end-to-end business workflow that crosses those files and functions
Graphify Building and querying a knowledge graph of code, documents, and relationships A graph explains how things connect; UnvibeCode additionally reconstructs business workflows, edge cases, and evidence-backed business risks
PR-Agent / Qodo Merge Reviewing pull requests, describing changes, and suggesting improvements around a diff PR review starts from changed code; UnvibeCode reverse-engineers the existing repository and its business workflows beyond a single change set
Repomix Packaging a repository into AI-friendly context for LLMs Repository context gives an LLM source material; UnvibeCode additionally reconstructs workflow logic, state changes, edge cases, and business consequences
UnvibeCode Connected code + business workflows + business logic + edge cases + evidence-backed business risks The codebase is reviewed through the business workflows it implements, not only files, graphs, diffs, or context packages

The core unit in UnvibeCode is not a file or a diff. It is the business workflow implemented across the codebase.

What developers found useful in real repository trials

Developer trials across public and personal repositories repeatedly highlighted three useful parts of the product:

  • Business risks that could be independently checked: in a trial on the Rich Python library, a developer independently reproduced a Business Risk Finding surfaced by UnvibeCode.
  • Business workflows instead of only repository structure: in a Django project, a developer found the Business Workflow Map useful for understanding workflows covering student records, API operations, registration, and authentication/dashboard delivery.
  • Useful output even when a repository is too large for the deeper review: in a trial on a repository with about 12.6M estimated source tokens across 3,914 source files, UnvibeCode still produced the Connected Code Map and downloadable repository context while safely skipping the deeper workflow review.

What is UnvibeCode?

UnvibeCode reverse-engineers a complex codebase into business workflows, connected code, edge cases, and evidence-backed risks.

How do you understand a complex codebase?

Start with business workflows, not individual files. UnvibeCode traces each workflow to its connected code, entry points, dependencies, state changes, and edge cases so developers can understand how the system actually works.

How do you trace business workflows in a codebase?

UnvibeCode reconstructs business workflows and business logic across files and functions and connects each workflow to its entry points, decisions, dependencies, state changes, and supporting code evidence.

Supported languages

UnvibeCode 0.3.3 supports connected-code mapping and LLM-context preparation for:

Language Recognized file types
Python .py
JavaScript .js, .jsx, .mjs, .cjs
TypeScript .ts, .tsx
Rust .rs
PHP .php
Ruby .rb
Web assets .html, .htm, .css

C, C++, Java, Go, C#, Kotlin, and Swift files are detected but are not yet included in full connected-code analysis.

Documentation

Support and feedback

For reproducible package problems or feature requests, open a GitHub issue.

For product questions, public-repository review requests, or collaboration enquiries, email divya.singaravelu@iiml.org.

Contributing and license

About

Complex code hides connections, workflows, and business risks.Unvibe complex code. Trace business workflows.

Topics

Resources

Contributing

Stars

110 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors