Skip to content

Repository files navigation

desprawl - unfuck your TypeScript project, by scoping and delivering cleanup work
Visually explore codebases to scope and deliver cleanup work.

npx desprawl

Example architecture analysis (but there's more!):

desprawl analysing the vscode repo, an architecture card grouping its modules

What it does

AI-touched repos sprawl: dupe modules, unreachable code, import cycles, deps nobody checked. desprawl reads the repo (files, git, imports, calls, deps) and turns what it finds into scoped, sized cleanup work, not a vague quality score.

  • structure - imports graphed and grouped into modules
  • execution - call graph visualized, naming unreachable code, recursion, repetition
  • api - endpoints served and call sites made, matched up, drawn in red across repos
  • dependencies - licence and security issues
  • history - commits classified by time, module, devs traced
  • tasks - all cleanups collected, ready to hand off to agents / dev team

UI Tabs: Overview, Modules, Execution, Files, History, Tasks, Graph.
CLI report + JSON output scriptable and agent ready.

MIT License. Forever no analytics, no tracking, no costs, no ads.

More in REFERENCE.md. Star this repo, then fork it. See CONTRIBUTING.md

lil bug GitHub package.json version NPM Downloads GitHub contributors

About

npx desprawl: visually browse any codebase. Scope and deliver cleanup work on legacy projects, tech debt and agentic-coding sprawl. Understand unfamiliar repos faster. One CLI+UI, usable by humans and agents.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages